NeoDB MCP Server
2025.01.08
2
Python社交书籍编目API 交互内容生成
NeoDB MCP Server 是一个用于与 NeoDB（一个社交书籍编目服务）交互的消息控制协议（MCP）服务器实现。该服务器提供了通过 NeoDB API 获取用户信息、搜索书籍和检索详细书籍信息的工具。
View on GitHub
Overview
基本能力
产品定位
NeoDB MCP Server 是一个用于与 NeoDB（社交书籍编目服务）交互的消息控制协议（MCP）服务器实现。
核心功能
- 获取用户信息：获取当前用户的基本信息。
- 搜索书籍：在编目中搜索书籍。
- 获取书籍详情：获取特定书籍的详细信息。
适用场景
- 需要与 NeoDB API 交互的开发者。
- 需要获取用户信息、搜索书籍或获取书籍详情的应用程序。
工具列表
- get-user-info：获取当前用户的基本信息，无需参数。
- search-books：搜索编目中的书籍，参数
query（字符串）：书籍搜索查询。 - get-book：获取特定书籍的详细信息，参数
book_id（字符串）：要检索的书籍 ID。
常见问题解答
- 如何获取访问令牌？
- 使用官方指南：官方文档。
- 使用自动化脚本：neodb-get-access-token。
使用教程
使用依赖
-
安装 UV 包安装程序：
bash curl -LsSf https://astral.sh/uv/install.sh | sh -
创建并激活 Python 虚拟环境：
bash uv venv source .venv/bin/activate # On Unix/macOS # or .venv\Scripts\activate # On Windows -
安装项目依赖：
bash uv pip install .
安装教程
- 按照上述步骤安装依赖。
- 配置
claude_desktop_config.json文件：json { "mcpServers": { "neodb": { "command": "uv", "args": [ "--directory", "<PATH_TO_PROJECT_DIR>", "run", "<PATH_TO_SCRIPT>", "<API_BASE> e.g. https://neodb.social", "<ACCESS_TOKEN>" ] } } }
调试方式
- 确保 UV 和虚拟环境已正确安装。
- 确保访问令牌和 API 基础 URL 已正确配置。
- 运行工具并检查输出是否符合预期。