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文件以獲取詳細信息。