neodb-mcp

🚀 新NeoDB MCP服务器

本项目是一个与NeoDB交互的MCP（消息控制协议）服务器实现，NeoDB是一个社交图书目录服务。此服务器提供了一系列工具，可通过NeoDB的API获取用户信息、搜索书籍以及检索书籍详细信息。

🚀 快速开始

本服务器可帮助你借助NeoDB的API，轻松获取用户信息、搜索书籍和查看书籍详细信息。

📦 安装指南

安装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. 获取用户信息

   • 功能：获取当前用户的最基本信息。
   • 参数：无需参数。

2. 搜索书籍

   • 功能：在目录中搜索项目。
   • 参数：
     • query（字符串）：用于搜索的查询语句。

3. 获取书籍详细信息

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

与Claude桌面配合使用

获取访问令牌

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

1. 使用官方指南：按照官方文档获取你的访问令牌。
2. 使用自动化脚本：你可以使用neodb-get-access-token脚本来简化获取访问令牌的过程。

更新配置claude_desktop_config.json

{
  "mcpServers": {
    "neodb": {
      "command": "uv",
      "args": [
        "--directory",
        "<项目目录路径>",
        "run",
        "<脚本路径>",
        "<API基础URL>，例如https://neodb.social",
        "<访问令牌>"
      ]
    }
  }
}

其中：

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

📄 许可证

该项目在MIT许可证下发布 - 查看LICENSE文件以获取详细信息。