Api.Airforce
MCP 伺服器

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