Space Frontiers MCP Server

Machine Library MCP Server

Space Frontiers Company の検索・AI 製品である Machine Library の公式 MCP サーバーです。

• エンドポイント： https://mcp.machinelibrary.ai（正規）
• サーバー名： machinelibrary；ツールには machinelibrary_ が接頭辞として付いています
• エージェントのインストールガイド： https://machinelibrary.ai/install.md

査読論文、書籍、特許、規格、Wikipedia、Reddit、Telegram、Discord、YouTube を対象とする、AI エージェント向けの検索レイヤーです。引用に利用できる、長さを制限した全文と正規のソース URI を返します。

https://mcp.machinelibrary.ai/ でホストされています（Streamable HTTP トランスポート、PKCE を使った OAuth 2.1、または Bearer API キーに対応）。

実例を試す： 研究を探し、根拠となる箇所を確認し、引用情報を保持する。 実際の実行での正確なツール呼び出しと観察結果に加え、研究チーム向けの簡単な評価チェックリストも含まれています。

ツール

以下の4つのコア検索ツールは読み取り専用で、冪等性があり、複数のサーバーを使うエージェント環境での競合を避けるために machinelibrary_ が接頭辞として付いています。このリポジトリでは、これらのツールを実装しています。ホストされたサーバーでは、machinelibrary_research（引用付きの研究回答）と、3つの書き込みツール machinelibrary_search_feedback、machinelibrary_comment_on_document、machinelibrary_vote_on_comment も公開されています。ツールガイドまたは tools/list を参照してください。

ツール	使用する場面
machinelibrary_search_documents	論文、書籍、特許、規格、Wikipedia、YouTube の文字起こし。引用や先行技術の調査に使用します。
machinelibrary_search_social	Reddit、Telegram チャンネル、Discord。ニュースやコミュニティでの議論に使用します。
machinelibrary_fetch_document	1つの正規 URI に対する、長さを制限した全文と最大50件の参考文献。デフォルトは40K文字で、最大100K文字に対応しています。
machinelibrary_search_in_document	1つの文書内で一致する最大5箇所の抜粋。約20Kトークンを超える文書に使用します。

検索では、ハイブリッドランキングによるコンパクトな結果がデフォルトで10件返され、最大30件に制限されています。各検索結果には、正規の source_uri、最大900文字のスニペット1件、最大800文字の概要プレビュー、スコア、著者、日付、種類、全文の推定サイズが含まれます。引用元へのバックリンクは、追加の有料検索が発生するため、machinelibrary_fetch_document で明示的に指定した場合のみ含まれます。

インストール

ホストされたサーバーには、Cursor、VS Code、Smithery 用のワンクリックリンクがある独自の /mcp インストールページがあります。

Claude Code（推奨）

claude mcp add --transport http --scope user machinelibrary https://mcp.machinelibrary.ai

初回使用時にブラウザーが開き、OAuth ログインが行われます。API キーを貼り付ける必要はありません。

Cursor / VS Code / Cline / Windsurf（HTTP）

{
  "mcpServers": {
    "machinelibrary": {
      "type": "http",
      "url": "https://mcp.machinelibrary.ai",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

API キーは https://machinelibrary.ai/keys で取得してください。

セルフホスト（stdio）

git clone https://github.com/SpaceFrontiers/mcp.git
cd mcp
uv sync
SEARCH_API_ENDPOINT=https://api.machinelibrary.ai \
MACHINELIBRARY_API_KEY=ml_xxx uv run fastmcp run mcp_server.py

stdio モードでは、環境変数が上流 API の認証情報として使用されます。 このコマンドでは、SEARCH_API_ENDPOINT を使って公開 Machine Library API を選択します。 既存のデプロイとの互換性のため、内部のデフォルト値は引き続き http://search-api です。 HTTP デプロイの場合は、SEARCH_API_ENDPOINT に信頼できる内部検索 API を、 USERS_API_ENDPOINT に内部ユーザー API を設定してください。認証 ミドルウェアは、検証済みの ID ヘッダーをその内部サービスに転送します。 OAuth では、https://api.machinelibrary.ai の認可サーバーと、 https://machinelibrary.ai でのブラウザーサインインを使用します。

料金

• 検索：基本料金 $0.01 + 返された結果1件あたり $0.001（MCP のデフォルトである10件の場合は $0.02）。
• 全文書の取得：$0.05。
• 文書内の抜粋検索：$0.015。
• 取得時に referenced_by_limit > 0 を指定すると、別途課金される検索が追加されます。

クレジットは https://machinelibrary.ai/payments で追加できます。

リポジトリの構成

• mcp_server.py — Starlette + FastMCP のエントリーポイント、OAuth の well-known エンドポイント。
• tools.py — Pydantic の出力スキーマを持つ 4 つのツール。
• prompts.py — deep_research_agent プロンプト。
• resources.py — machinelibrary://document/{uri_b64} URI テンプレート。
• auth.py — Bearer トークンの検証、Origin の許可リスト、MCP-Protocol-Version の確認。
• client.py — v2 検索 API 用の非同期 HTTP クライアント。
• server.json — 公式 MCP Registry エントリー。
• smithery.yaml — Smithery のデプロイ設定。
• registry.json — 社内レジストリのメタデータ。
• tests/ — pytest の単体テスト。

仕様への準拠

• トランスポート：Streamable HTTP、ステートレス。
• 認証：RFC 7591 の動的クライアント登録に対応した OAuth 2.1。長期間有効な API キーも使用できます。
• アノテーション：すべてのツールで readOnlyHint、idempotentHint、openWorldHint、destructiveHint:false を宣言します。
• 出力スキーマ：すべてのツールの outputSchema は、Pydantic の戻り値モデルから自動生成されます。
• リソース：ドキュメント用に 1 つの URI テンプレートを登録しています。
• 対応する仕様バージョン：2025-03-26、2025-06-18、2025-11-25。

開発

uv sync
uv run pytest
uv run ruff check .

mcp-name: io.github.SpaceFrontiers/mcp

互換性

既存のアカウントと API キーは引き続きそのまま使用でき、以前の https://mcp.spacefrontiers.org エンドポイントも引き続きサポートされます。新しいセットアップでは https://mcp.machinelibrary.ai を使用してください。従来の spacefrontiers_* ツール名は 2026-10-07 に廃止されました。machinelibrary_* 名を使用してください。セルフホスト可能な サーバーでは、MACHINELIBRARY_API_KEY が未設定の場合、引き続き SPACE_FRONTIERS_API_KEY を読み込みます。

ライセンス

MIT