Space Frontiers Search

🚀 空間フロンティア MCP サーバー

このプロジェクトは、空間フロンティア API とのインターフェースとして機能するモデルコンテキストプロトコル（MCP）サーバーを実装しています。このサーバーにより、言語モデルは定義されたツールを通じて空間フロンティアのデータソースと相互作用することができます。サーバーは FastAPI フレームワークと FastMCP ライブラリを使用しています。

⚠️ 重要提示

空間フロンティアは公開ホストされた MCP サーバーを提供しており、そのアドレスは https://mcp.spacefrontiers.org です。これを使用するには、https://spacefrontiers.org/developers/keys から API キーを取得し、リクエストに Authorization: Bearer <your_api_key> の形式でキーを含めてください。

✨ 主な機能

サーバーは以下のツールを公開しており、これらを使用して相互作用することができます。

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) 検索結果。

🔧 技術詳細

サーバーは以下の環境変数を使用しています。

📦 インストール

Claude App または STDIO 通信でサーバーを実行するには、ターミナルで以下のコマンドを実行してください。

uv run mcp run main.py

サーバーを実行する前に、SPACE_FRONTIERS_API_KEY 環境変数を設定していることを確認してください。

クロードデスクトップアプリケーション用の claude_desktop_config.json の例

以下は、空間フロンティア MCP サーバーをクロードデスクトップアプリケーションと統合するための設定例です。

{
  "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 キーに置き換えてください。