Books

mcp-books

Books MCP — Open Library API をラップします（無料、認証不要）

Pipeworx の一部です — AI エージェントを 1875 以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとの提携、推奨、公開はありません。

ツール

ツール	説明
search_books	タイトル、著者、キーワードで書籍を検索します。タイトル、著者、出版年、ISBN、表紙画像の URL を返します。詳しい情報を取得する前に書籍を見つけるために使用します。
get_book	ISBN-10 または ISBN-13 で指定した書籍の Open Library の版の詳細を取得します。タイトル、publish_date、number_of_pages、subjects（最大 10 件）、description、cover_url、および後続の get_author 呼び出しに使用する author_keys を返します。
get_author	著者キー（例：'OL23919A'）を使って、Open Library から著者のプロフィールを取得します。名前、生年月日、没年月日、略歴、Wikipedia の URL を返します。
get_book_work	work ID（例：「OL45804W」）を使って、Open Library の正規の「work」レコード（すべての版を通じた書籍の概念）を取得します。タイトル、説明、初版の出版日、主題、著者キーを返します。work_id（W で終わるキー）を見つけるには search_books を使用します。ISBN で特定の版を取得するには get_book を使用します。（Crossref の get_work との衝突を避けるため、get_book_work という名前です。）

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "books": {
      "url": "https://gateway.pipeworx.io/books/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/books/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使える一連のツール）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールとともに、共有ツールがおよそ 30 件表示されます。接続の initialize 応答には正確な対象範囲が示され、その日の状況を確認するための信頼できる情報となります。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うと、このパックでは対応していない質問にも、カタログ全体を横断して振り分ける ask_pipeworx を通じて回答できます。そのために MCP サーバーをもう 1 つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに 1 回接続してください。

または、フル Pipeworx ゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが一覧表示されます：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと 1875 以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx ですべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合は、HTTP 経由で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/books_search_books \
  -H 'Content-Type: application/json' \
  -d '{"query":"1984 George Orwell"}'

最初の呼び出しにアカウントは不要です。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/books_search_books を実行します。ツールを見つけるには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへのラウンドトリップも不要です：

{
  "mcpServers": {
    "books": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-books"]
    }
  }
}

または、直接実行して起動を確認します：

npx -y @pipeworx/mcp-books

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に対して、このパックのツールのみで応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。この機能は、上記のパックエンドポイントとフルゲートウェイの両方で使えます：

ask_pipeworx({ question: "your question about Books data" })

ゲートウェイが適切なツールを選び、引数を自動で設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT