使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现,它提供了一个工具,使 AI 助手能够通过书名在 Open Library 网站上搜索图书信息。服务器返回结构化的 JSON 数据,包含书名、作者、出版年份等元数据。

主要功能点

  • 图书书名搜索: 通过书名搜索 Open Library 中的图书信息。
  • 结构化响应: 以一致的 JSON 格式返回图书信息,方便 AI 助手解析和使用。
  • 错误处理: 提供完善的输入验证和错误报告机制。

安装步骤

  1. 克隆仓库
    git clone https://github.com/8enSmith/mcp-open-library.git
    cd mcp-open-library
  2. 安装依赖
    npm install
  3. 构建项目
    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