Pinpoint Flights

Pinpoint Flights MCP 服务

这是 Pinpoint Flights 托管 MCP 服务的源代码。Pinpoint Flights 是一款航班搜索工具，提供非常精细的筛选条件：精确的时间范围、直飞与价格之间的取舍、行李、票价规则、要避开的航空公司、灵活日期和行程时长、附近机场，以及同时搜索多个目的地。

用自己的话向助手询问航班。助手会填入筛选条件，询问所需信息，并返回最佳匹配结果及在 pinpoint.flights 上预订的链接。

佛罗里达州旅行销售商注册号：ST150266

使用方法

你无需运行此存储库中的任何内容。该服务已托管，并已列入官方 MCP Registry，名称为 flights.pinpoint/pinpoint-flights。

1. 在 https://pinpoint.flights/connect 获取免费的个人链接。链接格式如下： https://pinpoint.flights/mcp/<key>。
2. 通过以下两种方式之一将其添加到你的助手中：

   • 作为 URL： 将个人链接粘贴为自定义连接器（Gemini、Claude、ChatGPT）。

   • 作为标头： 连接到 https://pinpoint.flights/mcp，并将链接最后一段密钥作为 Authorization: Bearer <key> 发送。例如，在 Claude Code 中：

     claude mcp add --transport http pinpoint-flights https://pinpoint.flights/mcp \
       --header "Authorization: Bearer <key>"
     

即使没有密钥，服务仍会连接并列出其工具，但搜索时会告知你如何获取密钥。每个密钥每天都有一定的新搜索额度；重复过去 24 小时内的搜索不收费。仅在 Pinpoint Flights 能够销售旅行产品的地区发放密钥并售票。

工具

这里只有一个工具：search_flights，标注为只读。其参数就是筛选条件，全部为可选项：助手只发送你提到的内容，其余由默认值补足。

参数组	内容
origin, destination	地点、附近机场，以及作为备选项的多个目的地
departEarliest … returnLatest, arriveBy, tripLength, blackouts	固定或灵活的日期、截止时间、停留时长
outboundDays, returnDays, outboundTimes, returnTimes	星期几和具体时段，可设为要求或偏好
travelers, bags, cabin, fare, budget	出行人数、计入价格的行李、舱位、票价规则、价格上限
route, airlines, exactFlights, stopover, amenities	中途停站和转机、偏好或要避开的航空公司、指定航班

如果缺少会影响结果的信息（例如日期），则不会运行搜索：工具会返回问题，让助手先向你询问。

此存储库包含的内容

文件
src/lib/mcp/server.ts	MCP 协议：initialize、tools/list、tools/call
src/lib/mcp/search.ts	search_flights 工具：其架构、说明和结果呈现方式
src/lib/mcp/serve.ts、src/app/mcp/	两个 HTTP 地址，分别支持和不支持在 URL 中包含密钥
src/lib/mcp/keys.ts	连接器密钥的生成和校验方式
src/lib/mcp/server.json	MCP Registry 清单
tests/mcp.test.ts	测试

这是 Pinpoint Flights 代码库中服务端文件的副本，保存在此处以便查阅托管服务背后的代码。它不是独立项目，无法单独构建：搜索本身（规划器、票价提供商以及网站的其余部分）不属于此存储库。

问题与故障

在这里提交 issue，或发送邮件至 [email protected]。