NeoDB MCP 服务器

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

<a href="https://glama.ai/mcp/servers/1any3eeaza"><img width="380" height="200" src="https://glama.ai/mcp/servers/1any3eeaza/badge" alt="NeoDB Server MCP server" /></a>

安装

安装 UV

首先，安装 UV 包管理器：

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

创建虚拟环境

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

uv venv
source .venv/bin/activate  # 在 Unix/macOS 上
# 或
.venv\Scripts\activate     # 在 Windows 上

安装依赖

使用 UV 安装项目依赖：

uv pip install .

可用工具

服务器提供以下工具：

1. get-user-info

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

2. search-books

   • 在目录中搜索项目
   • 参数：
     • query (string)：图书的搜索查询

3. get-book

   • 获取有关特定图书的详细信息
   • 参数：
     • book_id (string)：要检索的图书的 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 文件。