MCP Open Library

🚀 MCP Open Library

MCP Open Library 是一個基於 Model Context Protocol (MCP) 的服務器，它藉助 Open Library API 讓 AI 助手能夠搜索書籍和作者信息，為 AI 與圖書數據的交互提供了強大支持。

🚀 快速開始

本項目實現了一個 MCP 服務器，為 AI 助手與 Open Library 交互提供了工具。它支持按書名搜索書籍、按姓名搜索作者、通過 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 Inspector 來測試服務器：

npm run inspector

訪問 MCP Inspector 並測試工具，例如：

與 MCP 客戶端一起使用

此服務器實現了 Model Context Protocol，這意味著它可以被任何與 MCP 兼容的 AI 助手或客戶端使用，例如 Claude Desktop。服務器提供了以下工具：

• 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）

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 Inspector

運行測試

npm test

🤝 貢獻說明

歡迎貢獻代碼！請隨時提交 Pull Request。

🙏 致謝

• Open Library API
• Model Context Protocol