NeoDB MCP Server

NeoDB MCP サーバー

NeoDBと連携するためのMessage Control Protocol（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. get-user-info

   • 現在のユーザーの基本情報を取得します
   • パラメーターは不要です

2. search-books

   • カタログ内のアイテムを検索します
   • パラメーター：
     • query（文字列）：書籍の検索クエリ

3. get-book

   • 特定の書籍の詳細情報を取得します
   • パラメーター：
     • book_id（文字列）：取得する書籍のID

Claude Desktopでの使用方法

アクセストークンを取得する

アクセストークンを取得する方法は2つあります。

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ファイルをご覧ください。