1. 从一堆 OpenAPI 到能被 AI 调用的 MCP Server如果你手里有一批自建的 OpenAPI 接口想让 Claude、Cline 这类 AI 工具直接发现并调用它们MCP Server 就是当前最顺手的桥。MCP 全称 Model Context Protocol它把「AI 能调用的函数」标准化成 Tool客户端连上 Server 后就能自动列出工具、按需调用。问题在于很多人卡在两个地方一是每个 OpenAPI 都手写一个 Tool几十个接口写下来又累又容易漏参数二是鉴权散落在各处本地调试和阿里云部署各配一套 Key换台机器就得重来。这篇就聚焦一个具体做法用 Python 把自建 OpenAPI 封装成 MCP Server核心注册逻辑压到 10 行左右再通过 TaoToken 的统一 Key 和 API 通道完成鉴权与调用。适合谁适合已经在本地或阿里云上跑着 OpenAPI 服务、想让 AI 工具稳定接入的开发者。读完你能拿到可复制的核心代码、config.toml 与 settings.json 配置骨架以及一次完整的 MCP 握手加工具调用验证动作。下面按「先跑通再优化」的顺序来每一步都能跟做。2. TaoToken 前置统一 Key 与 API 通道怎么准备在写 MCP Server 之前先把鉴权这条链路理顺。自建 OpenAPI 通常有自己的鉴权头而 AI 工具侧又需要一套稳定的调用凭证。TaoToken 在这里扮演的是统一入口你用它签发一个 KeyMCP Server 内部通过它的 API 通道去访问模型或转发请求这样本地、阿里云、CI 环境用的是同一套凭证不用到处改配置。先到官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录然后在控制台创建 API Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。创建后把 Key 存到环境变量里别写进代码export TAOTOKEN_API_KEYsk-你的key export TAOTOKEN_BASE_URLhttps://taotoken.net/api注意API 地址是 https://taotoken.net/api 不带任何查询参数。如果你后面要接 Claude Code 这类编码工具可以看 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 的接入说明要长期跑编码或 Agent 任务Coding Plan 在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入文档统一在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到参数问题先翻这里。这一步的目标很简单让 MCP Server 启动时能从环境变量读到 Key而不是硬编码。后面所有配置都围绕这个前提展开。3. 可复制配置10 行核心代码 config.toml settings.json3.1 环境与依赖Python 建议 3.10 以上装两个包就够pip install mcp httpxmcp提供 FastMCP 这类封装httpx用来请求你的 OpenAPI。如果你在阿里云 ECS 上部署记得安全组放行 MCP Server 监听的端口本地调试则不用管。3.2 10 行核心代码下面这段就是注册逻辑的主体把 OpenAPI 元数据转成 MCP Tool 并挂到 Server 上from mcp.server.fastmcp import FastMCP import httpx, os, json mcp FastMCP(openapi-mcp-server) BASE os.environ[OPENAPI_BASE] KEY os.environ[TAOTOKEN_API_KEY] def register(spec: dict): for name, meta in spec[tools].items(): def make(metameta): async def tool(**kwargs): async with httpx.AsyncClient() as c: r await c.request(meta[method], BASE meta[path], headers{Authorization: fBearer {KEY}}, jsonkwargs) return r.json() return tool mcp.tool(namename, descriptionmeta[desc])(make()) register(json.load(open(config.toml))) mcp.run(transportsse)严格说注册那几行是核心加上导入和启动刚好 10 行左右。它的思路是读一份描述文件遍历里面的工具定义为每个工具动态生成一个异步函数并注册。这样你新增接口时只改配置不动代码。3.3 config.toml 骨架把 OpenAPI 的路径、方法、描述写进配置MCP Server 启动时读取[server] name openapi-mcp-server port 8000 [tools.list_instances] method GET path /ecs/instances desc 列出当前区域的 ECS 实例 [tools.describe_vpc] method GET path /vpc/describe desc 查询 VPC 详情参数 vpc_id 必填每个[tools.xxx]对应一个 MCP Tooldesc会直接展示给 AI写得越清楚模型选工具的准确率越高。3.4 settings.json 骨架客户端侧Cline、Claude Desktop 等用这份配置连上你的 Server{ mcpServers: { openapi-mcp: { url: http://127.0.0.1:8000/sse, env: { TAOTOKEN_API_KEY: sk-你的key, OPENAPI_BASE: https://your-openapi.example.com } } } }本地用127.0.0.1阿里云部署就换成 ECS 公网或内网 IP。env里的 Key 和 Base 会被 Server 进程读取和前面环境变量的约定保持一致。4. 验证请求一次 MCP 握手与工具调用配置写完别急着接 AI 工具先用命令行确认 Server 能起来、工具能列出来。启动 Serverpython server.py看到监听 8000 端口的日志后另开一个终端做握手验证。MCP 的 SSE 通道会先发一个 endpoint 事件你可以用 curl 观察curl -N http://127.0.0.1:8000/sse正常会返回类似event: endpoint加一个带 session 的路径。拿到 session 后用 JSON-RPC 发一次tools/listcurl -X POST http://127.0.0.1:8000/messages?session_id你的session \ -H Content-Type: application/json \ -d {jsonrpc:2.0,id:1,method:tools/list,params:{}}返回里应该能看到list_instances、describe_vpc两个工具说明注册成功。接着调一次真实工具curl -X POST http://127.0.0.1:8000/messages?session_id你的session \ -H Content-Type: application/json \ -d {jsonrpc:2.0,id:2,method:tools/call,params:{name:list_instances,arguments:{}}}如果 OpenAPI 侧返回了实例列表整条链路就通了MCP 握手 → 工具发现 → 工具调用 → OpenAPI 响应。实测下来这一步能过后面接 Cline 基本不会出问题。5. 本篇常见错排查握手失败curl 一直挂起多半是 Server 没真正监听或者端口被占。先lsof -i:8000看占用再确认mcp.run的 transport 是sse而不是stdio。tools/list 返回空检查 config.toml 的解析。TOML 里[tools.xxx]的层级如果写错spec[tools]就是空字典。打印一下json.load的结果最快。工具调用报 401Key 没传进去。确认TAOTOKEN_API_KEY在启动进程的环境里可见客户端 settings.json 的env和 Server 读取的变量名要完全一致。阿里云部署后客户端连不上安全组没放行端口或者用了内网 IP 却从公网访问。公网访问就绑0.0.0.0并放行对应端口内网访问则确保客户端和 ECS 在同一 VPC。AI 工具选错工具desc写得太模糊。把每个工具的描述补上「什么时候用、参数含义」模型判断会准很多。6. 接下来怎么走链路跑通后你可以按需分流如果只是想让模型对话里能调这些工具去 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 试模型对话如果是排障和接入细节回到 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 管 Key配合 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 查文档如果要把这套 Server 长期挂在编码或 Agent 流程里Coding Plan 在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。一个实用技巧config.toml 里工具多了以后按业务分文件启动时合并加载避免单文件膨胀到几百行。另外把desc当成给模型看的 API 文档来写比事后调 prompt 有效得多。