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

Exa MCP Server
exa-labs
A
security
A
license
A
quality
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Last updated -
1
1,964
1,697
TypeScript
MIT License
Open-Ledger-MCP-Serverofficial
openledger
-
security
A
license
-
quality
A Model Context Protocol (MCP) server implementation for the OpenLedger API. This server provides structured context to AI models according to the MCP specification.
Last updated -
8
TypeScript
Apache 2.0
MCP Kibela
kj455
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants to search and access information stored in Kibela, supporting note search, retrieval, creation and updating.
Last updated -
6
107
9
TypeScript
MIT License
MCP Outline Server
Vortiago
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants like Claude to interact with Outline document services, supporting document searching, reading, creation, editing, and comment management.
Last updated -
25
19
Python
MIT License

View all related MCP servers

Appeared in Searches

A server for retrieving papers on arXiv

mcp-open-library

MCP开放图书馆

概述

特征

安装

通过 Smithery 安装

手动安装

用法

运行服务器

与 MCP 客户端一起使用

Docker

发展

项目结构

可用脚本

运行测试

贡献

致谢

Related MCP Servers

Exa MCP Server

Open-Ledger-MCP-Serverofficial

MCP Kibela

MCP Outline Server

Appeared in Searches

New MCP Servers

MCP directory API