Neodb MCP

🚀 新NeoDB MCPサーバー

このサーバーは、社交図書カタログサービスであるNeoDBと相互作用するMCP（メッセージ制御プロトコル）サーバーの実装です。NeoDBのAPIを通じて、ユーザー情報の取得、書籍の検索、書籍の詳細情報の取得などの機能を提供します。

🚀 クイックスタート

📦 インストール

1. UVのインストール

まず、UVパッケージマネージャーをインストールします。

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

2. 仮想環境の作成

UVを使用してPython仮想環境を作成し、アクティブ化します。

uv venv
source .venv/bin/activate  # Unix/macOSの場合
# または
.venv\Scripts\activate     # Windowsの場合

3. 依存関係のインストール

UVを使用してプロジェクトの依存関係をインストールします。

uv pip install .

✨ 主な機能

このサーバーは以下のツールを提供します。

1. ユーザー情報の取得

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

2. 書籍の検索

   • カタログ内で項目を検索します。
   • パラメーター：
     • query（文字列）：検索に使用するクエリ文。

3. 書籍の詳細情報の取得

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

💻 使用例

Claudeデスクトップとの連携

アクセストークンの取得

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

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ファイルを参照してください。