mcp-开放库

MCP开放图书馆

开放图书馆 API 的模型上下文协议 (MCP) 服务器，使 AI 助手能够搜索书籍和作者信息。

概述

该项目实现了一个 MCP 服务器，为 AI 助手提供与开放图书馆交互的工具。它支持按书名搜索图书信息、按姓名搜索作者、使用开放图书馆密钥检索作者详细信息，以及使用开放图书馆 ID (OLID) 获取作者照片的 URL。服务器返回图书和作者信息的结构化数据。

特征

按标题搜索书籍：使用标题搜索书籍（ get_book_by_title ）。
按姓名搜索作者：使用姓名搜索作者（ get_authors_by_name ）。
获取作者详细信息：使用开放图书馆密钥（ get_author_info ）检索特定作者的详细信息。
获取作者照片：使用作者的开放图书馆 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

手动安装

# Clone the repository
git clone https://github.com/your-username/mcp-open-library.git
cd mcp-open-library

# Install dependencies
npm install

# Build the project
npm run build

用法

运行服务器

您可以使用 MCP 检查器来测试服务器：

npm run inspector

访问 MCP 检查器，然后测试该工具，例如

替代文本

与 MCP 客户端一起使用

该服务器实现了模型上下文协议 (MCP)，这意味着它可以被任何兼容 MCP 的 AI 助手或客户端（例如Claude Desktop）使用。该服务器公开以下工具：

get_book_by_title ：按标题搜索书籍信息
get_authors_by_name ：按姓名搜索作者信息
get_author_info ：使用开放图书馆作者密钥获取特定作者的详细信息
get_author_photo ：使用开放图书馆作者 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

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

致谢

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

开放图书馆 API 的模型上下文协议 (MCP) 服务器，使 AI 助手能够搜索书籍信息。

Related MCP Servers

OpenAI MCP Server
arthurcolle
-
security
F
license
-
quality
A Model Context Protocol server implementation that enables connection between OpenAI APIs and MCP clients for coding assistance with features like CLI interaction, web API integration, and tool-based architecture.
Last updated -
33
Python
searchAPI-mcp
RmMargt
-
security
A
license
-
quality
A Model Context Protocol (MCP) based search API server that provides standardized access to Google Maps, Google Flights, Google Hotels and other services. This server enables AI assistants to access various search services through a unified interface.
Last updated -
57
Python
MIT License
Lspace MCP Serverofficial
Lspace-io
A
security
F
license
A
quality
An open-source server implementing the Model Context Protocol (MCP) that enables capturing insights from AI sessions and transforming them into persistent, searchable knowledge accessible across tools.
Last updated -
7
5
TypeScript
Google Research MCP
mixelpixx
-
security
A
license
-
quality
Model Context Protocol (MCP) server that provides AI assistants with advanced web research capabilities, including Google search integration, intelligent content extraction, and multi-source synthesis.
Last updated -
52
3
TypeScript
MIT License

View all related MCP servers

mcp-open-library

MCP开放图书馆

概述

特征

安装

通过 Smithery 安装

手动安装

用法

运行服务器

与 MCP 客户端一起使用

Docker

发展

项目结构

可用脚本

运行测试

贡献

致谢

Related MCP Servers

OpenAI MCP Server

searchAPI-mcp

Lspace MCP Serverofficial

Google Research MCP

Appeared in Searches

New MCP Servers

MCP directory API