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