使用说明
项目简介
本项目是一个基于 Model Context Protocol (MCP) 的服务器实现,它提供了一个工具,使 AI 助手能够通过书名在 Open Library 网站上搜索图书信息。服务器返回结构化的 JSON 数据,包含书名、作者、出版年份等元数据。
主要功能点
- 图书书名搜索: 通过书名搜索 Open Library 中的图书信息。
- 结构化响应: 以一致的 JSON 格式返回图书信息,方便 AI 助手解析和使用。
- 错误处理: 提供完善的输入验证和错误报告机制。
安装步骤
- 克隆仓库
git clone https://github.com/8enSmith/mcp-open-library.git cd mcp-open-library - 安装依赖
npm install - 构建项目
npm run build
服务器配置
MCP 客户端需要以下配置信息来连接到此 MCP 服务器。请将以下 JSON 配置添加到您的 MCP 客户端配置中,例如 Claude Desktop 的 Server 配置:
{ "serverName": "open-library-server", "command": "node", "args": ["dist/index.js"] }
配置参数说明:
- 'serverName': 服务器名称,设置为 "open-library-server"。
- 'command': 运行服务器的命令,这里使用 'node',因为服务器是 Node.js 应用。
- 'args': 传递给 'node' 命令的参数,'dist/index.js' 是构建后的服务器入口文件路径。
注意: 确保您已在项目根目录下执行 'npm run build' 命令,以便生成 'dist/index.js' 文件。
基本使用方法
此服务器提供一个名为 'get_book_by_title' 的工具。您可以使用 MCP 客户端调用此工具来搜索图书信息。
工具名称: 'get_book_by_title'
工具描述: 在 Open Library 上通过书名搜索图书。
输入参数:
{ "title": "书名" }
将 '"书名"' 替换为您要搜索的具体书名,例如 '"The Hobbit"'。
示例输入:
{ "title": "The Lord of the Rings" }
示例输出: 服务器将返回包含图书信息的 JSON 响应,例如:
{ "title": "The Lord of the Rings", "authors": [ "J.R.R. Tolkien" ], "first_publish_year": 1954, "open_library_work_key": "/works/OL45868W", "edition_count": 147, "cover_url": "https://covers.openlibrary.org/b/id/8731981-M.jpg" }
如果未找到匹配的图书,服务器将返回包含提示信息的文本内容。
信息
分类
网页与API