Cataloger MCP

🚀 编目器MCP服务器

这是一个模型上下文协议（MCP）服务器，它通过简单的API接口提供对美国国会图书馆主题词表（LCSH）的访问。

🚀 快速开始

该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桌面端配合设置

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搜索美国国会图书馆主题词表。以下是一些示例提示：

• “你能在美国国会图书馆主题词表中搜索‘人工智能’吗？”
• “在LCSH中查找‘气候变化’并告诉我官方主题词。”
• “与‘量子计算’相关的LCSH术语有哪些？”

Claude将使用MCP服务器查询LCSH和LCNAF数据库并返回结果。

• “查找‘Smith, John Adam’的名称规范记录。”
• “在LCSH中对‘环境政策’进行关键词搜索。”

✨ 主要特性

• MCP工具集成：提供search_lcsh（用于主题词，默认左锚定搜索）、search_lcsh_keyword（用于主题词，关键词搜索）和search_name_authority（用于个人姓名）工具，可供AI助手使用。
• 资源端点：在lcsh://search/{query}和lcnaf://search/{query}提供资源端点。
• 强大的错误处理：能够优雅地处理API错误、连接问题和意外的响应格式。
• 多种响应格式：支持LCSH API的字典（命中结果）和列表响应格式。

📚 详细文档

故障排除

如果你在使用MCP服务器时遇到问题：

1. 检查服务器状态：在Claude桌面端，转到设置> MCP服务器，检查服务器是否已启用并正在运行。
2. 重启服务器：切换服务器开关以重启它。
3. 检查控制台输出：如果手动运行服务器，请检查控制台输出是否有错误消息。
4. 验证网络连接：确保你的计算机有活动的互联网连接以访问LCSH API。

📄 许可证

本项目采用MIT许可证 - 有关详细信息，请参阅LICENSE文件。

📚 详细文档

开发者相关

有关服务器实现、API参考和测试信息的更详细文档，请参阅references.md文件。