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 服务器的工具仍然是通过函数调用到达模型的。