MCP Book Search

🚀 図書館検索MCPサーバー

Calil APIを使用した図書館検索用のMCP（モデルコンテキストプロトコル）サーバーです。このサーバーを使用することで、ClaudeなどのAIアシスタントが日本全国の図書館情報に直接アクセスできるようになります。

✨ 主な機能

• 都道府県名で図書館情報を検索する
• 図書館名や所在地など、図書館の基本情報を取得する
• AIアシスタントのツールとして使用できる

🚀 クイックスタート

💻 使用例

基本的な使用法

# 依存関係のインストール
npm install

# 環境変数の設定
# .envファイルを作成し、以下の内容を追加
CALIL_APPLICATION_KEY=あなたのCalilAPIキー

# プロジェクトのビルド
npm run build

# サーバーの起動
npm start

高度な使用法

// Claude Desktopの設定ファイル（通常は ~/.config/Claude Desktop/claude_desktop_config.json）に以下のエントリを追加
{
  "mcpServers": {
    "book-search": {
      "command": "node",
      "args": [
        "/absolute/path/to/dist/index.js"
      ],
      "env": {
        "CALIL_APPLICATION_KEY": "あなたのCalilAPIキー"
      }
    }
  }
}

接続テスト

# サーバーが正常に動作しているかを検証するコマンド
npm test

このテストでは以下の機能が検証されます：

• Calil APIへの接続
• 図書館情報の取得
• ツール呼び出しの処理

📦 インストール

前提条件

• Calil APIキーを取得する (https://calil.jp/api/dashboard/)
• Node.js v16以上のバージョン

ローカルでの実行

1. 依存関係をインストールする:

npm install

2. 環境変数を設定する: .env ファイルを作成し、以下の内容を追加します。

CALIL_APPLICATION_KEY=あなたのCalilAPIキー

3. プロジェクトをビルドする:

npm run build

4. サーバーを起動する:

npm start

Claude Desktopでの設定

Claude Desktopの設定ファイル（通常は ~/.config/Claude Desktop/claude_desktop_config.json）に以下のエントリを追加します。

{
  "mcpServers": {
    "book-search": {
      "command": "node",
      "args": [
        "/absolute/path/to/dist/index.js"
      ],
      "env": {
        "CALIL_APPLICATION_KEY": "あなたのCalilAPIキー"
      }
    }
  }
}

📚 ドキュメント

利用可能なツール

現在のMCPサーバーは以下のツールを提供しています。

get_libraries_by_prefecture

指定された都道府県で図書館情報を検索します。

パラメータ:

• prefecture: 都道府県名（例: 「東京都」、「大阪府」）

戻り値: 指定された都道府県内の図書館システムと図書館情報のリスト

search_books

（現在はプレースホルダー実装）書籍を検索します。

パラメータ:

• query: 検索キーワード

制限事項

• 現在は図書館情報の検索機能のみが実装されています。
• 図書検索機能は将来のバージョンで実装予定です。

📄 ライセンス

MIT