内容
# toolport-mcp-servers
**基于官方 OpenAPI 规格生成的全 API MCP 服务器。只需一个 `npx` 命令，无需构建步骤。**
大多数官方 MCP 服务器都会提供一些工具或一个笨拙的“调用 API”桥接器。但整个 API 都在供应商的 OpenAPI 规格中。本项目将该规格转化为一个真正的 MCP 服务器，工具名称友好，易于模型查找。
[](https://www.npmjs.com/package/toolport-mcp-servers) [](LICENSE)
> 非官方。基于公开的 OpenAPI 规格生成。不隶属于 Stripe、Clerk、Vercel 或任何 API 提供商。
## 服务器列表
| 服务器 | 工具数量 | 认证环境变量 |
|---|--:|---|
| **stripe** | **587** | `STRIPE_API_KEY` |
| **vercel** | **333** | `VERCEL_TOKEN` |
| **clerk** | **224** | `CLERK_SECRET_KEY` |
所有三个服务器都已准备好运行。无需安装，无需构建，无需密钥即可检查它们。
## 快速开始
将任何 MCP 客户端（Claude Desktop、Cursor、Cline、...）指向它。以服务器作为第一个参数：
```jsonc
{
"mcpServers": {
"stripe": {
"command": "npx",
"args": ["-y", "toolport-mcp-servers", "stripe"],
"env": { "STRIPE_API_KEY": "sk_live_..." }
},
"clerk": {
"command": "npx",
"args": ["-y", "toolport-mcp-servers", "clerk"],
"env": { "CLERK_SECRET_KEY": "sk_..." }
},
"vercel": {
"command": "npx",
"args": ["-y", "toolport-mcp-servers", "vercel"],
"env": { "VERCEL_TOKEN": "..." }
}
}
}
```
就这样。您的代理获得了完整的 API 作为干净、可调用的工具（`create_customer`、`create_deployment`、`create_invitation`、`list_organizations`，...）。
想在连接密钥之前查看线路？运行任何服务器的 dry-run（无需密钥）- 它打印每个工具将执行的确切 HTTP 请求：
```bash
npx -y toolport-mcp-servers stripe
```
## 为什么这些优于原始生成器
任何人都可以运行 OpenAPI 到工具的生成器。您得到的目录通常无法被代理使用：`PostCustomers`、`GetUsersUserIdOrganizationMemberships`。模型根据名称搜索，因此不好的名称是一个工具，代理永远找不到。这些服务器解决了这个问题：
- **意图友好的名称。** `PostCustomers` 变成 `create_customer`；`GetUserList` 变成 `list_users`。路径样式和动词样式的操作 ID 都规范化了。
- **丰富的描述。** 真实的领域词汇（支付：charge、refund、dispute、payout；认证：member、session、sign-in、magic link），以便自然查询匹配。
- **每个操作，而不仅仅是精选的几个。** 完整的写入表面，包括官方服务器遗漏的端点。
- **基准测试。** 名称和描述是针对真正的检索排名器进行调整的。在 Stripe 上，策划将 587 个工具的 recall@10 从 91% 提升到 96%（23 意图集）；核心子集达到 100%。
## 在 Toolport 后台（推荐）
运行任何一个独立的服务器，或将 [Toolport](https://toolport.app) 指向它们并获得：
- **延迟发现** - 您的代理看到几个元工具并按需搜索，因此 587 个工具几乎不会增加任何上下文。
- **人工审批** - 阻止破坏性调用（退款、删除用户、删除部署）进行一次性点击确认。
- **本地优先** - 密钥保留在您的 OS 密钥链中，任何内容都不会离开您的机器。
这就是全 API 服务器的意义所在：整个 API 都可达，而 Toolport 是使 587 个工具安全且廉价保留的层。
## 添加您自己的
任何 OpenAPI/Swagger API 都可以成为一个精选的 MCP 服务器。投放一个 `vendors/<name>.js` 配置（规格 URL、命名样式、领域词汇、认证环境变量），运行预备脚本，然后您就有一个新的 `npx toolport-mcp-servers <name>` 服务器。欢迎 PR。
```bash
git clone https://github.com/tsouth89/toolport-mcp-servers && cd toolport-mcp-servers
npm run prep:vercel # 示例：重新获取公共规格并重新生成
```
## 工作原理
操作 ID 转换为人类可读格式（路径样式和动词样式）加上描述丰富覆盖层，将原始 OpenAPI 生成的工具目录转换为意图形状的工具，并针对真正的 Toolport 排名器进行基准测试。生成的工件按供应商捆绑在 `data/` 中；转换为人类可读格式的工具和覆盖层位于 `src/` 中，每个服务器的配置是一个位于 `vendors/` 下的文件。
## 许可证
MIT。工具定义源自每个供应商的公共 OpenAPI 规格。不隶属于或得到任何 API 提供商的认可。供应商名称是其各自所有者的商标，仅在此用于标识每个服务器针对的 API。
