SkyAccess

SkyAccess MCP 服务

SkyAccess 是全球按挂牌量计算规模最大的空驶航段市场。这个免费、公开的 MCP 服务可让任何 AI 助手搜索 900 多家获 FAA Part 135 认证（及国际同等认证）的包机运营商提供的 5,000 多个实时空驶航班，价格通常比同等的整机包机低 25% 至 75%。它还会提供包机价格参考估算，以及旅客可打开的预订链接。

请使用托管端点。无需安装任何内容。

https://mcp.skyaccess.com/mcp

安装

以下每个选项都会将托管端点添加到你的客户端。你的机器上不会运行任何内容，也无需账户、注册或 API 密钥。

• Claude Code：

  claude mcp add --transport http skyaccess https://mcp.skyaccess.com/mcp
  

• Claude Code 插件（同一服务，另附一个技能，用于告诉 Claude 何时使用各个工具）：

  claude plugin marketplace add sky-access/skyaccess-mcp
  claude plugin install skyaccess@skyaccess
  

• Gemini CLI：

  gemini extensions install https://github.com/sky-access/skyaccess-mcp
  

• VS Code（GitHub Copilot）： 使用上方按钮，或运行：

  code --add-mcp '{"name":"skyaccess","type":"http","url":"https://mcp.skyaccess.com/mcp"}'
  

• **Claude（claude.ai 和 Claude Desktop）、Cursor 及其他客户端：**请参阅从 MCP 客户端连接。

其他客户端

此仓库还为以下每个客户端提供了一个软件包。它们都指向同一个托管端点，且不会在你的机器上运行任何内容。

Kiro

在 Powers 面板中选择 Add Custom Power，然后选择 Import power from GitHub，并输入 https://github.com/sky-access/skyaccess-mcp。 powers/skyaccess 中的 Power 会添加服务和一项技能，用于告诉 Kiro Agent 何时使用各个工具。

Gemini CLI

gemini extensions install https://github.com/sky-access/skyaccess-mcp

扩展定义在 gemini-extension.json 和 GEMINI.md 中。

Google Antigravity

将服务添加到 ~/.gemini/config/mcp_config.json，或添加到工作区中的 .agents/mcp_config.json。Antigravity 使用 serverUrl，而不是 url：

{ "mcpServers": { "skyaccess": { "serverUrl": "https://mcp.skyaccess.com/mcp" } } }

或者，从此仓库的克隆副本中使用 /plugin install <path-to-clone>/integrations/antigravity/skyaccess 安装插件文件夹。请参阅 integrations/antigravity/skyaccess。

GitHub Copilot CLI

copilot plugin marketplace add sky-access/skyaccess-mcp
copilot plugin install skyaccess@skyaccess

此操作会安装 plugins/skyaccess，其中包含 Agent Plugins 的 plugin.json 和 mcp.json，与 Claude Code 清单并列。

连接详情

端点	https://mcp.skyaccess.com/mcp
身份验证	无。该服务免费且匿名：无需账户、注册、API 密钥或 OAuth。
传输方式	Streamable HTTP，仅支持 POST，无状态。不会签发 Mcp-Session-Id，因此每个请求都是独立的。GET 按设计返回 405。
必需标头	Content-Type: application/json。Accept 可以是 MCP 规范值 application/json, text/event-stream、仅 application/json、*/*，也可以省略。若 Accept 值未列出 application/json 且不单独为 */*（例如 text/html 或仅 text/event-stream），则返回 406。
响应格式	使用 Accept: application/json, text/event-stream 时，每条回复都是一条 Server-Sent Events 消息：先是 event: message，然后是包含 JSON-RPC 响应的 data:。仅使用 application/json、*/* 或省略 Accept 标头时，每条回复都是纯 JSON（Content-Type: application/json）。
协议版本	2025-06-18。也支持协商 2025-11-25、2025-03-26 和 2024-11-05。
速率限制	工具调用：每个客户端 IP 每 60 秒 30 个请求。连接设置不计入限制。request_booking：每个客户端 IP 每小时 10 次包机咨询。请参阅速率限制。
覆盖范围	全球库存，大部分位于美国。价格和估算金额以 USD 计。
付款	无。没有工具会收取付款，也不包含付款字段。
支持	[email protected]
隐私政策	https://skyaccess.com/privacy#connector
服务条款	https://skyaccess.com/terms

从 MCP 客户端连接

任何支持通过 Streamable HTTP 连接远程 MCP 服务的客户端都可以直接使用该端点。身份验证留空。

• Claude（claude.ai 和 Claude Desktop）： 依次选择 Settings、Connectors、Add custom connector，然后粘贴 https://mcp.skyaccess.com/mcp。

• Claude Code、Gemini CLI 和 VS Code： 请参阅安装。

• Cursor： 将以下内容添加到 ~/.cursor/mcp.json：

  { "mcpServers": { "skyaccess": { "url": "https://mcp.skyaccess.com/mcp" } } }
  

• VS Code，手动配置： 将以下内容添加到工作区中的 .vscode/mcp.json：

  { "servers": { "skyaccess": { "type": "http", "url": "https://mcp.skyaccess.com/mcp" } } }
  

• 仅支持 stdio 的客户端（例如 Claude Desktop 的 claude_desktop_config.json 文件）：请使用此仓库中的桥接程序。请参阅本地安装程序和 stdio 桥接程序（npm 包）。

使用 curl 试用

列出工具：

curl -sS https://mcp.skyaccess.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

搜索空驶航段（只读）：

curl -sS https://mcp.skyaccess.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_empty_legs","arguments":{"origin":"Los Angeles","destination":"Las Vegas","passengers":4}}}'

该服务是无状态的，因此这两条命令无需 initialize 握手即可运行。MCP 客户端仍会发送握手请求，服务会正常响应。

工具

工具	类型	作用
search_empty_legs	只读	按 origin、destination、departureDateFrom、departureDateTo、passengers 和 max_price（美元）搜索实时空腿航班，所有参数均为可选。最多返回 5 个航班，包含航线、出发时间、整架飞机的价格（税费在结账时显示）、机型、座位数、便利设施、flightId 和预订链接。
get_flight	只读	根据 flightId 重新查询一个航班；如果该航班已无法预订，则会说明。
booking_handoff	只读	返回 flightId 对应的 SkyAccess 预订页面链接。此工具不会创建或保留预订，也不会更改任何信息；旅客可在该页面查看并预订。
get_charter_estimate	只读	返回包机的各机型类别对应的美元参考价格范围和飞行时间，航线为 origin 至 destination（passengers 和 aircraftCategory 为可选参数）。
request_booking	写入	将旅客姓名、电子邮箱和行程详情（origin、destination、departureDate、passengers，以及可选的 notes）发送给 SkyAccess。SkyAccess 专员会尽快通过电子邮件跟进，确认航班是否可订及价格。此工具不会收款，也不会创建预订。

price: null 表示该航班没有公布价格（SkyAccess 会显示“联系询价”）。即使设置了 max_price，也可能返回此类航班，因为其价格未知。

每个工具都带有 MCP 注解：四个只读工具将 readOnlyHint: true 设为真，request_booking 则将 readOnlyHint: false 设为假。

示例提示词

1. “帮我找本周从洛杉矶飞往拉斯维加斯、适合 4 人乘坐的私人飞机。”（search_empty_legs）
2. “有没有从迈阿密飞往巴哈马的便宜私人飞机航班？”（search_empty_legs）
3. “给我看看从泰特伯勒飞往棕榈滩的空腿航班，并提供最便宜航班的预订链接。”（search_empty_legs，然后调用 booking_handoff）
4. “从泰特伯勒包机飞往阿斯彭，6 人乘坐，大概要多少钱？”（get_charter_estimate）
5. “本周末有哪些从达拉斯出发的私人飞机优惠航班？”（search_empty_legs）
6. “从纽约飞往伦敦，8 名乘客乘坐私人飞机大概要多少钱？”（get_charter_estimate）

航班库存一直在变化，因此每次查询返回的航班可能不同。

数据与隐私

四个只读工具无需个人数据。request_booking 是唯一会发送个人数据的工具：旅客提供的姓名和电子邮箱，以及行程详情和任何备注，都会发送给 SkyAccess，以便专员回复。只有在旅客要求 SkyAccess 联系他们时，才调用此工具。

SkyAccess 处理这些数据的方式：https://skyaccess.com/privacy#connector

速率限制

当前限制按客户端 IP 计算：

• 工具调用：每 60 秒 30 次请求。 每个包含 tools/call 的请求计为 1 次。连接设置请求不计入：initialize、notifications/initialized、notifications/cancelled、tools/list、ping，以及 MCP 客户端为打开可选 SSE 流而发送的 GET 请求（响应为 405）。因此，客户端的一轮典型操作（连接、列出工具、调用一个工具）共计 1 次请求。其他任何方法均计入；超过 8 KB、采用分块传输或压缩的设置请求，以及重复包含设置方法的批处理请求也计入。计入限额的工具调用响应会带有 RateLimit-Policy: 30;w=60、RateLimit-Limit、RateLimit-Remaining 和 RateLimit-Reset 标头（request_booking 响应则带有每小时限额对应的值）；设置请求的响应不包含这些标头。
• 每小时 10 次包机咨询。 只有调用 request_booking 的请求才计入此限制。
• 每个请求： JSON-RPC 批处理最多可包含 4 次工具调用，且最多包含 1 次 request_booking 调用。超过此数量的批处理会返回 400。

超过限额时，服务会返回 HTTP 429，并附带 JSON-RPC 错误代码 -32029。RateLimit-Reset 标头会给出限额窗口重置前的秒数；请在此之后重试。

故障排除

症状	原因和解决方法
406 Not Acceptable	Accept 标头未列出 application/json，且不只是 */*（例如仅有 text/html 或 text/event-stream）。发送 Accept: application/json, text/event-stream、application/json 或 */*，也可以省略 Accept。
429、JSON-RPC 错误 -32029	已达到速率限制。“每分钟最多 30 个请求”是工具调用限制（建立连接不计入）；“每小时最多提交 10 个预订”是 request_booking 限制。等待 RateLimit-Reset 秒后重试。
405	请求使用了 GET。请通过 POST 发送 JSON-RPC。MCP 客户端会发送一次 GET 来打开可选的 SSE 流，并将收到的 405 视为“未提供流”；这是预期行为，也不计入速率限制。
400，“Only one request_booking call is allowed per request”或“At most 4 tool calls are allowed per request”	将 JSON-RPC 批处理拆分为更小的请求。
“No published empty leg flight matches that id.”	该航班已不再发布（已预订、撤回或已起飞），或者 ID 有误。请重新运行 search_empty_legs。
get_charter_estimate 返回“Estimate temporarily unavailable. Please try again.”	地名无法识别时也会返回相同消息。请使用主要城市名称或机场代码（例如 KTEB）重试。

本地安装程序和 stdio 桥接程序（npm 包）

skyaccess-mcp npm 包提供两项功能。它需要 Node 20 或更高版本，且没有运行时依赖。

1. 它会将 SkyAccess 条目写入在本机找到的受支持 MCP 客户端配置中（Cursor 和 Claude Desktop 配置文件），因此无需手动编辑 JSON。
2. 它为无法接收 URL 的客户端提供 stdio 到 HTTP 桥接程序。

npx -y skyaccess-mcp              # register with every supported client found on this machine
npx -y skyaccess-mcp --dry-run    # show what would be written, write nothing
npx -y skyaccess-mcp doctor       # check the endpoint and list its tools
npx -y skyaccess-mcp bridge       # the stdio to HTTP bridge (clients spawn this)

doctor 会检查端点并列出其工具。如果端点无法访问或未返回任何工具，它会以非零状态码退出。

如需与仅支持 stdio 的客户端（例如 Claude Desktop 的 claude_desktop_config.json）手动使用该桥接程序：

{
  "mcpServers": {
    "skyaccess": {
      "command": "npx",
      "args": ["-y", "skyaccess-mcp", "bridge"]
    }
  }
}

在本仓库的克隆目录中运行 node bin/skyaccess-mcp.mjs <command>，也可以使用相同的命令。

选项：--url <url>、--client <cursor|claude-desktop>、--dry-run、--help。

安装程序如何处理你的配置文件

• 仅当客户端自身的目录已存在时才会写入，因此不会在未安装 Cursor 的机器上创建 ~/.cursor。
• 它会保留文件中的其他所有键，因此你的其他 MCP 服务保持不变。
• 如果配置无法解析为 JSON，它会原样保留并报告问题；绝不会覆盖该配置。
• 替换现有 SkyAccess 条目前，会将其备份到 <config>.skyaccess-backup。

设计说明

• 没有运行时依赖，因此无需审查传递性供应链。使用纯 ESM，无需构建步骤：发布的内容就是 src/ 中的内容。
• 桥接程序仅向 stdout 写入 JSON-RPC，每行一条消息，并将所有诊断信息发送到 stderr。任何意外的 stdout 写入都会破坏协议。
• 收到 202 响应的通知不会产生 stdout 行，因为回复客户端未请求的内容违反协议。
• 请求的 HTTP 跳转失败时，会返回具有相同 id 的 JSON-RPC 错误，让客户端快速失败，而不是无限等待。

开发

npm install          # installs vitest, the only dev dependency
npm test             # offline suite against a real local HTTP server, no network
npm run test:live    # opt-in live suite against https://mcp.skyaccess.com/mcp

实时测试套件只会发送 initialize 和 tools/list。它不会纳入 npm test，因为它依赖 DNS 和公共互联网，而两者都无法说明代码是否正确。

清单文件

这些文件会将每个客户端指向托管端点。它们都不会运行代码。

文件	用途
gemini-extension.json、GEMINI.md	Gemini CLI 扩展（gemini extensions install）和 Gemini CLI 扩展库
.claude-plugin/marketplace.json	Claude Code 插件市场（claude plugin marketplace add sky-access/skyaccess-mcp）
plugins/skyaccess/	Claude Code 插件本身：.claude-plugin/plugin.json、.mcp.json、empty-legs 技能及其 README
plugins/skyaccess/plugin.json、plugins/skyaccess/mcp.json	同一插件采用 Agent Plugins 1.0.0 格式的版本，适用于 GitHub Copilot CLI、VS Code 和 Awesome Copilot 市场
powers/skyaccess/	采用 Agent Plugins 格式的 Kiro power：plugin.json、mcp.json、empty-legs 技能及其 README
integrations/antigravity/skyaccess/	Google Antigravity 插件：plugin.json（仅包含名称和描述）和 mcp_config.json（serverUrl）
integrations/dify/	Dify 工具插件的源文件，供 Dify Marketplace 使用：打包为 .difypkg 的四个只读工具

服务器版本更改时，请同步更新 gemini-extension.json、plugins/skyaccess/.claude-plugin/plugin.json、plugins/skyaccess/plugin.json 和 powers/skyaccess/plugin.json 中的 version。Antigravity 清单没有版本字段。Dify 插件在 integrations/dify/manifest.yaml 中有自己的版本。使用 claude plugin validate . 和 claude plugin validate ./plugins/skyaccess 检查 Claude Code 文件，并使用 gemini extensions validate . 检查 Gemini 扩展。

许可证

MIT。请参阅 LICENSE。