NeoDB MCP サーバー

ソーシャルブックカタログサービスであるNeoDBと連携するためのメッセージ制御プロトコル（MCP）サーバー実装。このサーバーは、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 .

Related MCP server: Yonote MCP Server

利用可能なツール

サーバーは次のツールを提供します。

1. ユーザー情報を取得する

   • 現在のユーザーの基本情報を取得します

   • パラメータは必要ありません

2. 検索書籍

   • カタログ内のアイテムを検索します

   • パラメータ:

     • query (文字列): 書籍の検索クエリ

3. 本を入手する

   • 特定の書籍に関する詳細情報を取得します

   • パラメータ:

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