Space Frontiers Search

🚀 空間前沿 MCP 服務器

本項目實現了一個模型上下文協議（MCP）服務器，它作為與空間前沿 API 的接口，允許語言模型通過預定義的工具與空間前沿數據源進行交互。該服務器基於 FastAPI 框架和 FastMCP 庫構建。

⚠️ 重要提示

空間前沿提供了公開託管的 MCP 服務器，地址為 https://mcp.spacefrontiers.org。要使用它，請從 https://spacefrontiers.org/developers/keys 獲取一個 API 密鑰，並在請求中包含該密鑰，格式為 Authorization: Bearer <your_api_key>。

🚀 快速開始

運行服務器

要運行服務器以供 Claude App 或 STDIO 通信使用，請在終端中執行以下命令：

uv run mcp run main.py

請確保在運行服務器之前設置了 SPACE_FRONTIERS_API_KEY 環境變量。

示例配置（用於 Claude 桌面應用程序的 claude_desktop_config.json）

以下是將空間前沿 MCP 服務器與 Claude 桌面應用程序集成的一個示例配置：

{
  "mcpServers": {
    "Space Frontiers MCP server": {
      "command": "/path/to/your/uv", // 替換為您實際的 uv 安裝路徑
      "args": [
        "run",
        "main.py"
      ],
      "env": {
        "SPACE_FRONTIERS_API_KEY": "<your_api_key>"
      }
    }
  }
}

⚠️ 重要提示

在配置文件中，請將 <your_api_key> 替換為您的實際 API 密鑰。

✨ 主要特性

服務器公開了以下工具用於與空間前沿數據源進行交互：

simple_search

對指定的空間前沿數據庫（圖書館、電報或 Reddit）執行關鍵字搜索。

• 參數：
  • source (SourceName)：要搜索的數據源（例如，“library”，“telegram”，“reddit”）。
  • query (str)：關鍵字搜索查詢。
  • limit (int)：要返回的最大結果數。
  • offset (int)：結果的起始偏移量。
• 返回值：(str) 搜索結果。

search

對指定的空間前沿數據庫（圖書館、電報或 Reddit）執行語義搜索。

• 參數：
  • query (str)：語義搜索查詢。
  • sources (list[SourceName] | None, optional)：要搜索的數據源列表，默認為 ["library"]。
  • filters (FiltersType | None, optional)：可選的過濾器應用於搜索，默認為 None。
  • limit (int, optional)：要返回的最大結果數，默認為 10。
• 返回值：(str) 搜索結果。

🔧 技術細節

環境變量

服務器使用以下環境變量：