Genesis Arbitrage

Genesis Arbitrage · · 阅读约 4 分钟

MCP(模型上下文协议)

MCP(Model Context Protocol,模型上下文协议)是一种开放协议,AI 应用通过它连接外部数据和工具:文件、数据库、API。Anthropic 于 2024 年 11 月将其开源,并在 2025 年 12 月把它捐赠给 Agentic AI Foundation,这是 Linux Foundation 旗下的定向基金。

MCP 如何工作

AI 应用称为主机(host),它为每个所连接的服务器创建一个 MCP 客户端。MCP 服务器是一个程序,对外提供工具(模型可以调用的函数)、资源(用于补充上下文的数据)和提示词(提示词模板)。消息采用 JSON-RPC 2.0,传输方式是:本地服务器用 stdio,远程服务器用 Streamable HTTP(MCP 文档)。

客户端通过 tools/list 请求列出工具,通过 tools/call 调用某个工具,并传入其名称和参数。每个工具都有 name、description 和 inputSchema,后者是其参数的 JSON Schema。

基于 REST API 的 MCP

行情数据的 MCP 服务器通常是 REST API 之上的一层薄封装:一个工具对应一次 HTTP 请求。API 密钥保存在服务器的环境变量中,只出现在请求头里(认证);模型只能看到工具描述和响应。

Genesis API 没有官方 MCP 服务器,需要你自己编写封装;下面是基于官方 Python 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:
    """通过 Genesis API 获取某币种在各交易所的资金费率。

    Args:
        coin: 币种代码,例如 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 获取某币种在各交易所的资金费率。

另请参阅:函数调用、OpenAPI、API 密钥、面向 AI 智能体的加密货币市场数据、面向 AI 智能体的 Genesis API。

常见问题

MCP 与函数调用有什么区别?

函数调用是模型 API 的一项功能:应用随请求发送工具描述,并自行执行调用。MCP 则是应用与工具服务器之间的协议,因此同一个服务器可以配合任何支持 MCP 的客户端使用。在应用内部,来自 MCP 服务器的工具仍然是通过函数调用到达模型的。