DATPAQ

---

托管于 https://mcp.datpaq.com/，也可在本地安装并自行托管。

datpaq-mcp-http 通过可流式传输的 HTTP 将 Datpaq API 封装为 MCP 工具，因此任何兼容 MCP 的客户端（Claude Desktop、Cursor、Codex、Cline、Continue、Agent 框架）都能通过单个连接调用 Datpaq 端点。

如需了解本地 CLI（以及随其提供、供 Claude Desktop 使用的 stdio MCP），请参阅 github.com/datpaq/cli。

连接

URL	https://mcp.datpaq.com/
传输方式	可流式传输的 HTTP
协议	2026-07-28 和 2025-11-25（及更早版本）——参见协议版本
身份验证	Authorization: Bearer YOUR_DATPAQ_API_KEY（每个请求）
工具	覆盖 63 个活跃 API 的托管工具

使用 curl 验证——新版（2026-07-28）：

curl -s -X POST https://mcp.datpaq.com/ -H "Authorization: Bearer $YOUR_DATPAQ_API_KEY" -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -H "MCP-Protocol-Version: 2026-07-28" -H "Mcp-Method: server/discover" -d '{"jsonrpc":"2.0","id":1,"method":"server/discover","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientInfo":{"name":"curl","version":"0"},"io.modelcontextprotocol/clientCapabilities":{}}}}'

或者使用旧版（initialize 握手），其行为保持不变：

curl -s -X POST https://mcp.datpaq.com/ -H "Authorization: Bearer $YOUR_DATPAQ_API_KEY" -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'

协议版本

该服务采用双时代模式：在同一端点上同时支持无状态的 2026-07-28 修订版和基于握手的修订版（2025-11-25 及更早版本），并按请求选择。你无需进行任何配置——只需将客户端指向该 URL，服务就会使用客户端支持的版本。

时代	版本	提供方式
新版	2026-07-28	无状态。每个请求都在 _meta 中携带版本、客户端信息和功能，并将其映射到 MCP-Protocol-Version / Mcp-Method / Mcp-Name 标头。实现 server/discover、tools/list、tools/call。
旧版	2025-11-25、2025-06-18、2025-03-26、2024-11-05	与以往完全相同的 initialize 握手。会话、GET SSE 流和 Mcp-Session-Id 均继续可用。

新版说明：

• tools/list 和 server/discover 会返回 ttlMs 和 cacheScope: "public" 缓存提示。所有租户的工具目录都相同，且仅在重新部署时发生变化，因此客户端可以缓存该目录，无需在每次重新连接时重新获取每个工具定义。
• Mcp-Method 和 Mcp-Name 会根据请求正文进行验证。若标头与正文不一致，请求会被拒绝，并返回 -32020 HeaderMismatch；若缺少标头，服务仍会处理请求，因此尚未实现标头映射的客户端也能正常工作。
• 对于不受支持的版本，服务会返回 400 + -32022，并列出支持的版本，因此客户端可以重试，而不是直接失败。
• 规范在 2026-07-28 中弃用的功能——roots、sampling、logging、DCR 以及 2024-11-05 HTTP+SSE 传输方式——本服务从未使用，因此对你没有任何影响。

**身份验证模式：**每个请求都必须提供 Datpaq API 密钥，格式为 Authorization: Bearer <key>——服务本身不持有凭据，因此单个实例可为多个租户提供服务，费用分别计入各自的 Datpaq 账户。

配置客户端

Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "datpaq": {
      "url": "https://mcp.datpaq.com/",
      "headers": {
        "Authorization": "Bearer YOUR_DATPAQ_API_KEY"
      }
    }
  }
}

Cursor（~/.cursor/mcp.json 或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "datpaq": {
      "url": "https://mcp.datpaq.com/",
      "headers": {
        "Authorization": "Bearer YOUR_DATPAQ_API_KEY"
      }
    }
  }
}

Codex CLI：

export DATPAQ_API_KEY="YOUR_DATPAQ_API_KEY"
codex mcp add datpaq --url https://mcp.datpaq.com/ --bearer-token-env-var DATPAQ_API_KEY

Codex TOML：

[mcp_servers.datpaq]
url = "https://mcp.datpaq.com/"
bearer_token_env_var = "YOUR_DATPAQ_API_KEY"

如需查看各客户端的完整分步说明（包括 Cline 和 Continue），请参阅 Datpaq MCP 文档。

自托管

通过 Go 安装：

go install github.com/datpaq/mcp/cmd/datpaq-mcp-http@latest

需要 Go 1.26.3+。

或者拉取 Docker 镜像：

docker build -t datpaq-mcp-http -f cmd/datpaq-mcp-http/Dockerfile .
docker run -p 8080:8080 datpaq-mcp-http

运行：

datpaq-mcp-http --addr :8080

然后将 MCP 客户端指向 http://localhost:8080/。

内置 Fly.io 配置，可通过一条命令部署：

fly launch --config fly.toml
fly deploy

无需配置密钥——客户端在每次请求中进行身份验证。

暴露的内容

服务会为每个活跃的 Datpaq API 端点注册一个 MCP 工具。活跃端点列表由 internal/cli/active-apis.json 维护——当 datpaq.com 上发布新的 API 时，在此添加其 slug，重新部署后，该工具就会显示给每个已连接的客户端。

非活跃 API 会从 MCP 界面中彻底移除（CLI 则仍允许直接调用它们）。这样可以让托管工具列表聚焦于已可用于生产环境的端点。

依赖本地状态或会在用户机器上调用 shell 命令的工具（身份验证流程、配置写入器等）不会注册——请参阅 internal/mcp/public_tools.go。

配置

变量	用途
DATPAQ_BASE_URL	覆盖 API 基础 URL（默认值：https://datpaq.com/api/v1）——可用于指向暂存环境
PORT	HTTP 监听端口（默认值：8080，也可通过 --addr 配置）

Datpaq API 密钥不是服务端变量。每个请求都必须通过 Authorization: Bearer <key> 携带该密钥。请参阅快速入门中的身份验证模型。

管理活跃 API

活跃端点列表由 internal/cli/active-apis.json 维护。CLI 仓库是从管理面板导出内容重新生成此清单的权威来源（或在第 2 阶段使用 GET /api/v1/catalog/active）。此仓库通过同步接收更新——不会自带获取工具。

{
  "active": [
    "convert-time",
    "ip-geolocation",
    "..."
  ]
}

规范工作流（相邻的检出目录为 ../CLI）：

# In the CLI repo
cd ../CLI
make fetch-active-apis CATALOG_INPUT=./export.json   # or CATALOG_URL=... after Phase 2
make sync-active-apis                                 # CLI → MCP

# Then here
make build && make test
# commit internal/cli/active-apis.json + code changes, deploy

如果误在此仓库中编辑了 active-apis.json，请使用 ./scripts/sync-active-apis.sh 将其推回 CLI（仅 MCP → CLI）。日常更新请优先使用上述 CLI 优先流程。

开发

git clone https://github.com/datpaq/mcp && cd mcp
make build
./bin/datpaq-mcp-http --addr :8080

运行测试：

make test

许可证

Apache 2.0——请参阅 LICENSE。