NeoDB MCP 服务器

一个消息控制协议 (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 .

Related MCP server: Yonote MCP Server

可用工具

该服务器提供以下工具：

1. 获取用户信息

   • 获取当前用户的基本信息

   • 无需参数

2. 搜索书籍

   • 搜索目录中的项目

   • 参数：

     • query （字符串）：书籍的搜索查询

3. 获取书籍

   • 获取特定书籍的详细信息

   • 参数：

     • 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文件。