Space Frontiers MCP 服务器

概述

本项目实现了一个模型上下文协议 (MCP) 服务器，作为 Space Frontiers API 的接口。它允许语言模型通过定义的工具与 Space Frontiers 数据源进行交互。该服务器使用 FastAPI 和 FastMCP 库构建。

注意： Space Frontiers 在 https://mcp.spacefrontiers.org 上提供了一个公开托管的 MCP 服务器。要使用它，请从 https://spacefrontiers.org/developers/keys 获取 API 密钥，并使用 Authorization: Bearer <your_api_key> 标头将其包含在您的请求中。

工具

服务器公开以下工具以进行交互：

simple_search

对指定的 Space Frontiers 数据库（library、telegram 或 reddit）执行关键字搜索。

参数：

• source (SourceName)：要搜索的数据源（例如，“library”、“telegram”、“reddit”）。
• query (str)：关键字搜索查询。
• limit (int)：要返回的最大结果数。
• offset (int)：结果的起始偏移量。

返回： (str) 搜索结果。

search

对指定的 Space Frontiers 数据库（library、telegram 或 reddit）执行语义搜索。

参数：

• query (str)：语义搜索查询。
• sources (list[SourceName], optional)：要搜索的数据源列表。默认为 ["library"]。
• filters (FiltersType | None, optional)：应用于搜索的可选过滤器。默认为 None。
• limit (int, optional)：要返回的最大结果数。默认为 10。

返回： (str) 搜索结果。

环境变量

服务器使用以下环境变量：

• SPACE_FRONTIERS_API_ENDPOINT：Space Frontiers API 的基本 URL。
  • 默认值： https://api.spacefrontiers.org
• SPACE_FRONTIERS_API_KEY：用于验证对 Space Frontiers API 请求的可选 API 密钥。
  • 注意： 也可以通过请求标头提供身份验证：
    • Authorization: Bearer <your_api_key>
    • X-Api-Key: <your_api_key>
    • 或者，可以通过 X-User-Id 标头提供用户 ID。 如果未提供这些标头，服务器将尝试使用 SPACE_FRONTIERS_API_KEY 环境变量（如果已设置）。
    • 关于 X-User-Id 的说明： 此标头仅供 Space Frontiers 内部使用，不能用于外部身份验证。

运行服务器

(有关如何运行服务器的说明，例如，使用 Docker 或 uvicorn，可以在此处添加)