Space Frontiers MCP 服务器

概述

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

注意： Space Frontiers 提供了一个公开托管的MCP服务器位于 https://mcp.spacefrontiers.org。要使用它，请从 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], 可选): 要搜索的数据源列表。默认为 ["library"]。
• filters (FiltersType | None, 可选): 应用到搜索中的可选过滤器。默认为 None。
• limit (int, 可选): 返回结果的最大数量。默认为 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内部使用，不能用于外部认证。

运行服务器

为了运行服务器以配合Claude App或STDIO通信，在您的终端中执行以下命令：

uv run mcp run main.py

确保在运行服务器之前设置了 SPACE_FRONTIERS_API_KEY 环境变量。

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