x

xytangme

@xytangme/neodb-mcp
0 Stars 290 次浏览 xytangme 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "neodb": {
      "args": [
        "--directory",
        "\u003cPATH_TO_PROJECT_DIR\u003e",
        "run",
        "\u003cPATH_TO_SCRIPT\u003e",
        "\u003cAPI_BASE\u003e e.g. https://neodb.social",
        "\u003cACCESS_TOKEN\u003e"
      ],
      "command": "uv"
    }
  }
}

服务介绍

NeoDB MCP 服务器

这是一个用于与 NeoDB(一个社交书籍目录服务)交互的消息控制协议 (MCP) 服务器实现。该服务器通过 NeoDB 的 API 提供了获取用户信息、搜索书籍和检索详细书籍信息的工具。

设置

安装 UV

首先,安装 UV 包管理器:

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

创建虚拟环境

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

bash
uv venv
source .venv/bin/activate # 在 Unix/macOS 上

或者

.venvScriptsactivate # 在 Windows 上

安装依赖

使用 UV 安装项目依赖:

bash
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

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

相关 MCP 服务