消息控制协议服务器

NeoDB MCP服务器是一个用于与社交图书编目服务NeoDB交互的消息控制协议实现,提供获取用户信息、搜索图书和检索详细图书信息的功能。

  • by xytangme
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 xytangme/neodb-mcp

使用说明

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 .

可用工具

服务器提供以下工具:

  1. 获取用户信息

    • 获取当前用户的基本信息
    • 无需参数
  2. 搜索书籍

    • 在目录中搜索项目
    • 参数:
      • query (string):图书搜索查询
  3. 获取书籍

    • 获取特定书籍的详细信息
    • 参数:
      • book_id (string):要检索的图书的ID

使用Claude Desktop

获取访问令牌

有两种方法可以获取您的访问令牌:

  1. 使用官方指南:遵循 官方文件 获取您的访问令牌。

  2. 使用自动脚本:您可以使用 neodb获取访问令牌 该脚本提供了一种获取访问令牌的简化方法。

更新配置 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许可证获得许可-请参阅 许可证 文件以获取详细信息。