MCP书籍探索器（或“MCP图书浏览器”）
一个MCP（模型上下文协议）服务器，允许使用Open Library API探索书籍。此服务器提供工具来搜索书籍、获取详细信息、管理收藏夹以及生成AI评论。
这个项目是做什么的？
MCP Book Explorer 是一个服务器，提供以下功能：
工具（Herramientas）
- 搜索书籍在Open Library中按标题、作者或主题搜索书籍
- 获取书籍详情获取特定书籍的详细信息
- 添加到收藏夹将书籍添加到你的本地收藏列表
资源（Recursos）
- 收藏列表列出所有标记为收藏的书籍
提示（模板）
- 书籍评论提示生成一个结构化的提示，以便让大型语言模型（LLM）创作书评
先决条件
- Python 3.10或更高版本
- pip（Python包管理器）
安装
- 克隆或下载此存储库
- 安装依赖项：
pip install -r requirements.txt执行
要启动MCP服务器：
python server.py服务器将以stdio模式运行，通过标准输入/输出等待MCP命令。
如何证明它
选项1：使用Claude Desktop或类似工具
- 在你的客户端（如Claude Desktop等）上配置MCP服务器
- 一旦连接上，你就可以使用可用的工具：
搜索书籍：
Busca libros sobre "inteligencia artificial"获取详细信息：
Dame los detalles del libro con work_key "/works/OL45804W"添加到收藏夹：
Agrega el libro "/works/OL45804W" a mis favoritos查看收藏夹：
Muéstrame mi lista de favoritos生成评论：
Usa el prompt de reseña para "1984 de George Orwell"选项2：使用MCP Inspector进行手动测试
- 安装MCP Inspector：
npx @modelcontextprotocol/inspector python server.py- 在浏览器中打开检查员提供的URL
- 通过网页界面试用工具
选项3：与Claude Desktop集成
- 编辑Claude Desktop的配置文件：
- Windows： %APPDATA%\Claude\claude_desktop_config.json - macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
- 添加服务器配置：
{
"mcpServers": {
"book-explorer": {
"command": "python",
"args": ["c:\\Programming\\mcp-book-explorer\\server.py"]
}
}
}- 重启Claude Desktop
- 服务器将随时可用，你可以让Claude帮你搜索书籍、管理收藏等。
项目结构
mcp-book-explorer/
├── server.py # Servidor MCP principal
├── prompts.py # Plantillas de prompts
├── utils/
│ └── openlibrary.py # Cliente API de Open Library
├── data/
│ └── favorites.json # Almacenamiento de favoritos (generado automáticamente)
├── requirements.txt # Dependencias de Python
├── .gitignore # Archivos ignorados por Git
└── README.md # Este archivo存储的数据
收藏的书籍会保存在本地 data/favorites.json这个文件会在你首次使用该功能时自动创建 add_favorite。
所使用的技术
- FastMCP快速创建MCP服务器的框架
- httpxPython的现代HTTP客户端
- 开放图书馆API书籍数据源
笔记
- 默认搜索返回5个结果（可配置）
- 收藏夹仅通过
work_key，但并非书中的全部信息 - 服务器使用Open Library的公共API，无需认证