Cataloger MCP

🚀 カタロガーMCPサーバー

シンプルなAPIインターフェースを通じて、米国議会図書館の主題見出し（LCSH）にアクセスできるモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

このMCPサーバーを使用すると、ClaudeのようなAIアシスタントが、公開されているsuggest2 APIを使って米国議会図書館の主題見出し（LCSH）を検索できます。LCSHデータを照会し、APIからのさまざまな応答形式を処理するためのクリーンなインターフェースを提供します。

📦 インストール

オプション1：PyPIからインストール（推奨）

カタロガーMCPサーバーをインストールする最も簡単な方法は、直接PyPIからインストールすることです。

pip install cataloger-mcp-server

オプション2：ソースからインストール

ソースからインストールする場合は、次の手順を実行します。

git clone https://github.com/kltng/cataloger-mcp-server.git
cd cataloger-mcp-server
pip install -e .

💻 使用例

基本的な使用法

Claude Desktopでのセットアップ方法：

1. まだインストールしていない場合は、https://claude.ai/desktop から Claude Desktopをインストール します。
2. 上記のインストール方法のいずれかを使用して、カタロガーMCPサーバーをインストール します。
3. Claude Desktopを開き、設定に移動します。
   • 左下隅のプロフィール画像をクリックします。
   • メニューから「設定」を選択します。
4. MCPサーバーを構成 します。
   • 設定パネルで、「MCPサーバー」をクリックします。
   • 「サーバーを追加」をクリックします。
   • 以下の詳細を入力します。
     • 名前：cataloger mcp search
     • コマンド：cataloger-mcp-server
   • 「保存」をクリックします。
5. サーバーを有効化 します。
   • カタロガーMCP検索サーバーの横のスイッチをオンにして、サーバーを有効にします。
   • これで、ClaudeはLCSH検索機能にアクセスできるようになります。

高度な使用法

Claude Desktopでサーバーをセットアップして有効にしたら、Claudeに米国議会図書館の主題見出しを検索するように依頼できます。以下はいくつかの例です。

• "Can you search the Library of Congress Subject Headings for 'artificial intelligence'?"
• "Look up 'climate change' in LCSH and tell me the official subject headings."
• "What are the LCSH terms related to 'quantum computing'?"

ClaudeはMCPサーバーを使用して、LCSHおよびLCNAFデータベースを照会し、結果を返します。

• "Find the name authority record for 'Smith, John Adam'."
• "Perform a keyword search in LCSH for 'environmental policy'."

✨ 主な機能

• MCPツール統合：AIアシスタントが使用できる search_lcsh（主題見出しの検索、デフォルトは左アンカー検索）、search_lcsh_keyword（主題見出しのキーワード検索）、および search_name_authority（人名の検索）ツールを公開します。
• リソースエンドポイント：lcsh://search/{query} および lcnaf://search/{query} のリソースエンドポイントを提供します。
• 堅牢なエラーハンドリング：APIエラー、接続問題、および予期しない応答形式を適切に処理します。
• 複数の応答形式：LCSH APIからの辞書（ヒット）およびリストの両方の応答形式をサポートします。

📚 ドキュメント

トラブルシューティング

MCPサーバーで問題が発生した場合は、以下の手順を試してください。

1. サーバーの状態を確認：Claude Desktopで、設定 > MCPサーバーに移動し、サーバーが有効になっていて実行中であることを確認します。
2. サーバーを再起動：サーバーのスイッチをオフにしてから再度オンにします。
3. コンソール出力を確認：サーバーを手動で実行している場合は、コンソール出力にエラーメッセージがないか確認します。
4. ネットワーク接続を確認：コンピューターがLCSH APIにアクセスするためのアクティブなインターネット接続を持っていることを確認します。

開発者向け

サーバーの実装、APIリファレンス、およびテスト情報に関するより詳細なドキュメントについては、references.md ファイルを参照してください。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。