Cataloger MCP

🚀 編目器MCP服務器

編目器MCP服務器是一個基於模型上下文協議（MCP）的服務器，它通過簡單的API接口，讓用戶能夠訪問美國國會圖書館主題詞表（LCSH）。

🚀 快速開始

本MCP服務器允許像Claude這樣的AI助手，利用公共的suggest2 API搜索美國國會圖書館主題詞表（LCSH）。它為查詢LCSH數據提供了簡潔的接口，並能處理API返回的各種響應格式。

📦 安裝指南

選項1：從PyPI安裝（推薦）

從PyPI直接安裝編目器MCP服務器是最簡單的方法：

pip install cataloger-mcp-server

選項2：從源代碼安裝

如果你更傾向於從源代碼安裝：

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

📚 詳細文檔

與Claude桌面版集成設置

1. 安裝Claude桌面版：如果你還沒有安裝Claude桌面版，請從 https://claude.ai/desktop 下載安裝。
2. 安裝編目器MCP服務器：使用上述任意一種安裝方法安裝編目器MCP服務器。
3. 打開Claude桌面版並進入設置：
   • 點擊左下角的個人頭像。
   • 從菜單中選擇“設置”。
4. 配置MCP服務器：
   • 在設置面板中，點擊“MCP服務器”。
   • 點擊“添加服務器”。
   • 填寫以下詳細信息：
     • 名稱：cataloger mcp search
     • 命令：cataloger-mcp-server
   • 點擊“保存”。
5. 啟用服務器：
   • 打開編目器MCP搜索服務器旁邊的開關以啟用它。
   • 此時Claude就可以使用LCSH搜索功能了。

使用編目器MCP服務器與Claude交互

在Claude桌面版中設置並啟用服務器後，你可以讓Claude搜索美國國會圖書館主題詞表。以下是一些示例提示：

• "你能在美國國會圖書館主題詞表中搜索'人工智能'嗎？"
• "在美國國會圖書館主題詞表中查找'氣候變化'，並告訴我官方的主題詞。"
• "與'量子計算'相關的美國國會圖書館主題詞有哪些？"

Claude將使用MCP服務器查詢LCSH和LCNAF數據庫並返回結果。

• "查找'史密斯，約翰·亞當'的名稱規範記錄。"
• "在美國國會圖書館主題詞表中對'環境政策'進行關鍵詞搜索。"

✨ 主要特性

• MCP工具集成：提供了 search_lcsh（用於主題詞，默認左錨定搜索）、search_lcsh_keyword（用於主題詞，關鍵詞搜索）和 search_name_authority（用於個人姓名）等工具，可供AI助手使用。
• 資源端點：提供了 lcsh://search/{query} 和 lcnaf://search/{query} 資源端點。
• 強大的錯誤處理：能夠優雅地處理API錯誤、連接問題和意外的響應格式。
• 多種響應格式：支持LCSH API的字典（命中結果）和列表響應格式。

🔧 技術細節

本項目的服務器實現、API參考和測試信息的詳細文檔，請參考 references.md 文件。

🛠️ 故障排除

如果你在使用MCP服務器時遇到問題，可以按照以下步驟進行排查：

1. 檢查服務器狀態：在Claude桌面版中，進入設置> MCP服務器，檢查服務器是否已啟用並正在運行。
2. 重啟服務器：關閉再重新打開服務器開關。
3. 檢查控制檯輸出：如果是手動運行服務器，請檢查控制檯輸出是否有錯誤信息。
4. 驗證網絡連接：確保你的計算機可以正常訪問LCSH API。

📄 許可證

本項目採用MIT許可證 - 詳情請參閱LICENSE文件。