MCP 服务器

将任意 Model Context Protocol 客户端连接到 Api.Airforce——把我们的模型、图像、模型列表和余额作为 MCP 工具使用，费用计入你的账户。

什么是 MCP？

Model Context Protocol（MCP）让 AI 智能体客户端（如 Claude Desktop、Cursor 或任何支持 MCP 的应用）能够把外部服务作为工具调用。Api.Airforce 提供一个远程 MCP 服务器，使这些客户端可以直接使用我们的模型。

端点与传输

服务器在单一端点上通过 Streamable HTTP 使用 JSON-RPC 2.0，协议版本为 2025-06-18。发送 Accept: text/event-stream 请求头时返回流式响应。

POST https://api.airforce/mcp

身份验证

在 Authorization 请求头中发送你的 Api.Airforce API 密钥或 OAuth 2.0 bearer 令牌。未认证的请求返回 401，并带有指向我们 OAuth 元数据的 WWW-Authenticate 质询，因此兼容客户端可自动启动 OAuth 流程。

对于 OAuth 令牌，相关的 scope 为 profile（用于 get_balance）、chat（用于 chat_completion）和 images（用于 generate_image）。

连接客户端

大多数客户端接受远程 MCP 服务器 URL 加 bearer 令牌。典型配置如下：

{
  "mcpServers": {
    "api-airforce": {
      "url": "https://api.airforce/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

你可以通过 JSON-RPC initialize 调用手动验证连接：

curl -X POST https://api.airforce/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-app","version":"1.0.0"}}}'

可用工具

调用 tools/list 在运行时发现它们。共有四个工具可用：

list_models

列出可用模型及其价格和能力标志。

get_balance

返回你的按量付费余额（美分）和当前套餐。OAuth 令牌需要 profile scope。

chat_completion

执行与 OpenAI 兼容的聊天补全。计费方式与 POST /v1/chat/completions 完全相同。

generate_image

生成图像。计费方式与 POST /v1/images/generations 完全相同。

curl -X POST https://api.airforce/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

计费

chat_completion 和 generate_image 按与 REST API 相同的费率计入你的账户——没有单独的 MCP 价格。list_models 和 get_balance 免费。

发现

为实现自动发现，发布了机器可读的服务器卡片：

https://api.airforce/.well-known/mcp/server-card.json