MCP Open Library

🚀 MCP Open Library

このプロジェクトは、AIアシスタントが図書や著者情報を検索できるようにするOpen Library API用のModel Context Protocol (MCP)サーバーです。

🚀 クイックスタート

このプロジェクトは、AIアシスタントがOpen Libraryとやり取りするためのツールを提供するMCPサーバーを実装しています。タイトルで図書情報を検索したり、名前で著者を検索したり、Open Libraryキーを使用して著者の詳細情報を取得したり、Open Library ID (OLID)を使用して著者の写真のURLを取得したりすることができます。サーバーは、図書と著者の情報に対して構造化されたデータを返します。

✨ 主な機能

• タイトルによる図書検索：タイトルを使用して図書を検索します (get_book_by_title)。
• 名前による著者検索：名前を使用して著者を検索します (get_authors_by_name)。
• 著者詳細の取得：Open Libraryキーを使用して特定の著者の詳細情報を取得します (get_author_info)。
• 著者写真の取得：Open Library ID (OLID)を使用して著者の写真のURLを取得します (get_author_photo)。
• 図書表紙の取得：さまざまな識別子 (ISBN、OCLC、LCCN、OLID、ID)を使用して図書の表紙画像のURLを取得します (get_book_cover)。

📦 インストール

Smitheryを介したインストール

Smitheryを介してClaude Desktop用のMCP Open Libraryを自動的にインストールするには、次のコマンドを実行します。

npx -y @smithery/cli install @8enSmith/mcp-open-library --client claude

手動インストール

# リポジトリをクローンする
git clone https://github.com/your-username/mcp-open-library.git
cd mcp-open-library

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

💻 使用例

サーバーの実行

MCPインスペクターを使用してサーバーをテストできます。

npm run inspector

MCPインスペクターにアクセスしてから、ツールをテストします。例えば：

MCPクライアントとの使用

このサーバーはModel Context Protocolを実装しているため、Claude DesktopなどのMCP互換のAIアシスタントまたはクライアントで使用できます。サーバーは次のツールを公開しています。

• get_book_by_title：タイトルで図書情報を検索します。
• get_authors_by_name：名前で著者情報を検索します。
• get_author_info：Open Library著者キーを使用して特定の著者の詳細情報を取得します。
• get_author_photo：Open Library著者ID (OLID)を使用して著者の写真のURLを取得します。
• get_book_cover：特定の識別子 (ISBN、OCLC、LCCN、OLID、またはID)を使用して図書の表紙画像のURLを取得します。

基本的な使用法

get_book_by_titleの入力例：

{
  "title": "The Hobbit"
}

get_book_by_titleの出力例：

[
  {
    "title": "The Hobbit",
    "authors": [
      "J. R. R. Tolkien"
    ],
    "first_publish_year": 1937,
    "open_library_work_key": "/works/OL45883W",
    "edition_count": 120,
    "cover_url": "https://covers.openlibrary.org/b/id/10581294-M.jpg"
  }
]

get_authors_by_nameの入力例：

{
  "name": "J.R.R. Tolkien"
}

get_authors_by_nameの出力例：

[
  {
    "key": "OL26320A",
    "name": "J. R. R. Tolkien",
    "alternate_names": [
      "John Ronald Reuel Tolkien"
    ],
    "birth_date": "3 January 1892",
    "top_work": "The Hobbit",
    "work_count": 648
  }
]

get_author_infoの入力例：

{
  "author_key": "OL26320A"
}

get_author_infoの出力例：

{
  "name": "J. R. R. Tolkien",
  "personal_name": "John Ronald Reuel Tolkien",
  "birth_date": "3 January 1892",
  "death_date": "2 September 1973",
  "bio": "John Ronald Reuel Tolkien (1892-1973) was a major scholar of the English language, specializing in Old and Middle English. He served as the Rawlinson and Bosworth Professor of Anglo-Saxon and later the Merton Professor of English Language and Literature at Oxford University.",
  "alternate_names": ["John Ronald Reuel Tolkien"],
  "photos": [6791763],
  "key": "/authors/OL26320A",
  "remote_ids": {
    "viaf": "95218067",
    "wikidata": "Q892"
  },
  "revision": 43,
  "last_modified": {
    "type": "/type/datetime",
    "value": "2023-02-12T05:50:22.881"
  }
}

get_author_photoの入力例：

{
  "olid": "OL26320A"
}

get_author_photoの出力例：

https://covers.openlibrary.org/a/olid/OL26320A-L.jpg

get_book_coverの入力例：

{
  "key": "ISBN",
  "value": "9780547928227",
  "size": "L"
}

get_book_coverの出力例：

https://covers.openlibrary.org/b/isbn/9780547928227-L.jpg

get_book_coverツールは次のパラメータを受け入れます。

• key：識別子のタイプ (次のいずれか：ISBN、OCLC、LCCN、OLID、またはID)
• value：識別子の値
• size：オプションの表紙サイズ (Sは小、Mは中、Lは大、デフォルトはL)

Claude Desktopでこのツールを使用する例はこちらで確認できます。

高度な使用法

Dockerを使用したテスト

Dockerを使用してこのMCPサーバーをテストできます。まず、次のコマンドを実行します。

docker build -t mcp-open-library .
docker run -p 8080:8080 mcp-open-library

次に、インスペクターを介してDocker内で実行されているサーバーをテストできます。例えば：

pnpm run inspector http://localhost:8080

🔧 技術詳細

プロジェクト構造

• src/index.ts - メインサーバーの実装
• src/types.ts - TypeScriptの型定義
• src/index.test.ts - テストスイート

利用可能なスクリプト

• npm run build - TypeScriptコードをビルドします。
• npm run watch - 変更を監視して再ビルドします。
• npm test - テストスイートを実行します。
• npm run format - Prettierでコードを整形します。
• npm run inspector - サーバーに対してMCPインスペクターを実行します。

テストの実行

npm test

🤝 コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

🙏 謝辞

• Open Library API
• Model Context Protocol