Genesis Arbitrage

Genesis Arbitrage · · 3 دقیقه مطالعه

MCP (Model Context Protocol)

MCP (Model Context Protocol) پروتکل بازی است که برنامه‌های هوش مصنوعی از طریق آن به داده‌ها و ابزارهای بیرونی وصل می‌شوند: فایل‌ها، پایگاه‌های داده، APIها. Anthropic آن را در نوامبر 2024 متن‌باز کرد و در دسامبر 2025 به Agentic AI Foundation، صندوقی هدایت‌شده زیر نظر Linux Foundation، اهدا کرد.

MCP چگونه کار می‌کند

برنامه هوش مصنوعی که میزبان (host) نامیده می‌شود، برای هر سروری که به آن وصل می‌شود یک کلاینت MCP می‌سازد. سرور MCP برنامه‌ای است که ابزار (tools، توابعی که مدل می‌تواند صدا بزند)، منبع (resources، داده برای زمینه) و پرامپت (prompts، قالب‌های پرامپت) ارائه می‌دهد. پیام‌ها از JSON-RPC 2.0 استفاده می‌کنند و انتقال برای سرور محلی stdio و برای سرور راه دور Streamable HTTP است (مستندات MCP).

کلاینت ابزارها را با درخواست tools/list فهرست می‌کند و یکی را با tools/call و ارسال نام و آرگومان‌هایش فراخوانی می‌کند. هر ابزار یک name، یک description و یک inputSchema دارد که JSON Schema آرگومان‌هایش است.

MCP روی یک REST API

سرور MCP برای داده‌های بازار معمولاً پوششی نازک روی یک REST API است: یک ابزار، یک درخواست HTTP. کلید API در محیط سرور می‌ماند و فقط در هدر درخواست حرکت می‌کند (احراز هویت); مدل فقط توضیح ابزار و پاسخ را می‌بیند.

Genesis API سرور MCP رسمی ندارد. پوشش را خودتان می‌نویسید؛ این یک نمونه حداقلی با SDK رسمی پایتون است (بسته mcp نسخه 2.0 یا بالاتر، به‌علاوه requests):

import os

import requests
from mcp.server import MCPServer

API = "https://api.genesisarbitrage.com/v1"
mcp = MCPServer("genesis-funding")


@mcp.tool()
def funding_rates(coin: str) -> str:
    """A coin's funding rates across exchanges from Genesis API.

    Args:
        coin: coin ticker, for example BTC
    """
    r = requests.get(
        f"{API}/funding/rates",
        headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
        params={"coin": coin.upper()},
        timeout=10,
    )
    return r.text  # JSON: data و meta، یا error همراه با کد


if __name__ == "__main__":
    mcp.run(transport="stdio")

دستیاری که MCP را پشتیبانی می‌کند این فایل را به‌عنوان سرور محلی اجرا می‌کند (دستور اجرا در تنظیمات آن می‌رود) و ابزاری به نام funding_rates می‌گیرد: نرخ‌های فاندینگ یک کوین در صرافی‌ها از /funding/rates.

همچنین ببینید: function calling، OpenAPI، کلید API، داده‌های بازار ارز دیجیتال برای ایجنت‌های هوش مصنوعی، Genesis API برای ایجنت‌های هوش مصنوعی.

پرسش و پاسخ

MCP با function calling چه فرقی دارد؟

Function calling قابلیتی در API مدل است: برنامه توضیح ابزارها را همراه درخواست می‌فرستد و خودش فراخوانی‌ها را اجرا می‌کند. MCP پروتکلی میان برنامه و سرور ابزار است، پس یک سرور با هر کلاینتِ پشتیبان MCP کار می‌کند. داخل برنامه، ابزارهای سرورهای MCP هم باز از طریق function calling به مدل می‌رسند.