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)مشکلی در مستندات پیدا کردید؟ تیکت بزنید