NeoDB MCP Server

NeoDB MCP 服务

一个用于与 NeoDB 交互的消息控制协议（MCP）服务实现。NeoDB 是一个社交图书编目服务。此服务通过 NeoDB API 提供获取用户信息、搜索图书和检索详细图书信息的工具。

设置

安装 UV

首先，安装 UV 包安装程序：

curl -LsSf https://astral.sh/uv/install.sh | sh

创建虚拟环境

使用 UV 创建并激活 Python 虚拟环境：

uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate     # On Windows

安装依赖项

使用 UV 安装项目依赖项：

uv pip install .

可用工具

此服务提供以下工具：

1. get-user-info

   • 获取当前用户的基本信息
   • 无需参数

2. search-books

   • 搜索目录中的条目
   • 参数：
     • query（字符串）：图书搜索查询

3. get-book

   • 获取特定图书的详细信息
   • 参数：
     • book_id（字符串）：要检索的图书 ID

与 Claude Desktop 配合使用

获取访问令牌

有两种方式可以获取访问令牌：

1. 使用官方指南：按照官方文档获取访问令牌。

2. 使用自动化脚本：你可以使用 neodb-get-access-token 脚本，轻松获取访问令牌。

更新配置 claude_desktop_config.json

{
  "mcpServers": {
    "neodb": {
      "command": "uv",
      "args": [
        "--directory",
        "<PATH_TO_PROJECT_DIR>",
        "run",
        "<PATH_TO_SCRIPT>",
        "<API_BASE> e.g. https://neodb.social",
        "<ACCESS_TOKEN>"
      ]
    }
  }
}

其中：

• <API_BASE>：NeoDB API 的基础 URL
• <ACCESS_TOKEN>：你的 NeoDB API 访问令牌

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。