Rayno DocsRayno Cloud v2.2.0
docsmcp

پروتکل MCP و هوش مصنوعی

مشخصات Model Context Protocol، ابزارهای مدیریت برنامه و دیتابیس با هوش مصنوعی.

# پروتکل هوش مصنوعی و اتوماسیون (Model Context Protocol - MCP)

پلتفرم راینو کلاد به صورت بومی از پروتکل Model Context Protocol (MCP) پشتیبانی می‌کند. این پروتکل به دستیاران هوشمند، ایجنت‌های نرم‌افزاری و خطوط لوله خودکار اجازه می‌دهد تا زیرساخت ابری را با استانداردهای سخت‌گیرانه امنیتی مدیریت کنند.


۱. امنیت پاکت‌های اجرایی (Canonical Envelopes)

تمامی ابزارهای مخرب و تغییردهنده وضعیت (Mutating Tools) نیازمند تأییدیه با پاکت‌های استاندارد هستند:

  • استاندارد RFC 8785 (JCS): بدنه پارامترهای اکشن به صورت متعارف (Canonical JSON) مرتب‌سازی و سریالایز می‌شود.
  • اعتبارسنجی هش SHA-256: هش محتوای اکشن توسط کلاینت محاسبه شده و در هدر پاکت قرار می‌گیرد تا از هرگونه دستکاری در طول مسیر (MITM) جلوگیری شود.

sequenceDiagram
    participant Agent as AI Agent / MCP Client
    participant MCP as Rayno MCP Server (/api/v1/mcp/rpc)
    participant Console as Rayno Web Console (HITL)
    participant CP as Control Plane API

    Agent->>MCP: OAuth 2.1 + PKCE (S256) Token Request
    MCP-->>Agent: Scoped Access Token (mcp:read / mcp:deploy / mcp:destructive)
    Agent->>MCP: JSON-RPC 2.0 Tool Call + RFC 8785 Canonical SHA-256 Envelope
    alt Destructive Action (delete / terminate / restore)
        MCP-->>Agent: 202 Pending Approval + 10-min Confirmation Token
        MCP->>Console: Push Approval Request to Tenant Console
        Console->>MCP: Human Approves Envelope Hash
    end
    MCP->>CP: Execute Tenant-Isolated Operation
    CP-->>MCP: Verified Result + Audit Log Entry
    MCP-->>Agent: JSON-RPC 2.0 Response

۲. مشخصات ابزارهای عملیاتی (Tool Specifications)

ابزار rayno_manage_app

مدیریت چرخه حیات کانتینرها و سرویس‌های PaaS:

{
  "name": "rayno_manage_app",
  "description": "استقرار، مقیاس‌دهی و مدیریت برنامه‌های کانتینری",
  "parameters": {
    "type": "object",
    "properties": {
      "action": { "type": "string", "enum": ["deploy", "scale", "restart", "stop", "delete"] },
      "app_name": { "type": "string" },
      "image": { "type": "string", "description": "آدرس کامل OCI Image" },
      "cpu_cores": { "type": "number" },
      "ram_gb": { "type": "number" },
      "env_vars": { "type": "object" }
    },
    "required": ["action", "app_name"]
  }
}

ابزار rayno_manage_database

مدیریت کلاسترهای دیتابیس پایگاه داده رابطه‌ای و سندی:

{
  "name": "rayno_manage_database",
  "description": "ساخت، پشتیبان‌گیری و تغییر مقیاس دیتابیس",
  "parameters": {
    "type": "object",
    "properties": {
      "action": { "type": "string", "enum": ["create", "backup", "restore", "resize", "terminate"] },
      "db_name": { "type": "string" },
      "engine": { "type": "string", "enum": ["POSTGRESQL", "MYSQL", "REDIS", "MONGODB"] },
      "disk_gb": { "type": "integer" }
    },
    "required": ["action", "db_name"]
  }
}

ابزار rayno_get_metrics

دریافت متریک‌های بلادرنگ مصرف منابع:

{
  "name": "rayno_get_metrics",
  "description": "استعلام مصرف لحظه‌ای پردازنده، رم و ترافیک",
  "parameters": {
    "type": "object",
    "properties": {
      "resource_type": { "type": "string", "enum": ["app", "database", "node"] },
      "resource_id": { "type": "string" },
      "time_range": { "type": "string", "enum": ["1h", "6h", "24h", "7d"] }
    },
    "required": ["resource_type", "resource_id"]
  }
}

۳. اتصال به سرور MCP

برای اتصال Claude Desktop، کلاینت‌های LLM یا CLI به سرور MCP راینو کلاد:

{
  "mcpServers": {
    "rayno-cloud": {
      "command": "rayno",
      "args": ["mcp", "serve"],
      "env": {
        "RAYNO_API_KEY": "psk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
آخرین به‌روزرسانی: مستندات نسخه پلتفرم (Rayno Cloud v2.2.0)مشکلی در مستندات پیدا کردید؟ تیکت بزنید