cataloger mcp server

Сервер протокола контекста модели (MCP), предоставляющий доступ к предметным рубрикам Библиотеки Конгресса (LCSH) через простой API-интерфейс.

Обзор

Этот MCP-сервер позволяет ИИ-ассистентам, таким как Claude, выполнять поиск по предметным рубрикам Библиотеки Конгресса (LCSH) с использованием публичного API suggest2. Он предоставляет удобный интерфейс для запроса данных LCSH и обработки различных форматов ответов от API.

Related MCP server: MeSH MCP

Установка

Вариант 1: Установка из PyPI (рекомендуется)

Самый простой способ установить cataloger mcp server — напрямую из 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. Установите Claude Desktop, если вы еще этого не сделали, перейдя по ссылке https://claude.ai/desktop

2. Установите cataloger mcp server, используя один из способов установки выше

3. Откройте Claude Desktop и перейдите в настройки:

   • Нажмите на изображение своего профиля в левом нижнем углу

   • Выберите "Settings" (Настройки) в меню

4. Настройте MCP-сервер:

   • В панели настроек нажмите на "MCP Servers"

   • Нажмите "Add Server"

   • Заполните следующие данные:

     • Name: cataloger mcp search

     • Command: cataloger-mcp-server

   • Нажмите "Save"

5. Включите сервер:

   • Переключите переключатель рядом с сервером cataloger mcp search, чтобы включить его

   • Теперь у Claude будет доступ к возможностям поиска LCSH

Настройка в Cherry Studio

1. Установите Cherry Studio, следуя инструкциям в документации Cherry: https://docs.cherry-ai.com/docs/en-us/advanced-basic/mcp/install

2. Установите cataloger mcp server, используя один из способов установки выше.

3. Подготовьте JSON-конфигурацию MCP для Cherry Studio. Используйте метод "Import JSON" со следующим фрагментом:

   {
     "mcpServers": {
       "cataloger-mcp": {
         "command": "uvx",
         "args": ["cataloger-mcp-server"]
       }
     }
   }

   • Вы можете изменить ключ "cataloger-mcp" на любую метку, которую предпочитаете в Cherry Studio.

4. Импорт в Cherry Studio:

   • Откройте Cherry Studio и перейдите в Settings → MCP (или MCP Servers).

   • Нажмите Add / Import from JSON (формулировка может немного отличаться в зависимости от версии).

   • Вставьте JSON-фрагмент выше и подтвердите добавление сервера.

5. Проверка сервера:

   • Убедитесь, что новая запись cataloger-mcp-server появилась в списке MCP и включена.

   • Начните новый чат и убедитесь, что Cherry Studio может вызывать инструменты cataloger MCP.

Использование cataloger mcp server с Claude

Как только сервер настроен и включен в 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: Предоставляет инструменты search_lcsh (для предметных рубрик, поиск по умолчанию с привязкой к началу строки), search_lcsh_keyword (для предметных рубрик, поиск по ключевым словам) и search_name_authority (для имен собственных), которые могут использоваться ИИ-ассистентами.

• Конечные точки ресурсов: Предоставляет конечные точки ресурсов по адресам lcsh://search/{query} и lcnaf://search/{query}.

• Надежная обработка ошибок: Корректно обрабатывает ошибки API, проблемы с подключением и неожиданные форматы ответов.

• Множественные форматы ответов: Поддерживает как словарные (hits), так и списочные форматы ответов от API LCSH.

Устранение неполадок

Если вы столкнулись с проблемами при работе с MCP-сервером:

1. Проверьте статус сервера: В Claude Desktop перейдите в Settings > MCP Servers и проверьте, включен ли сервер и работает ли он.

2. Перезапустите сервер: Выключите и снова включите сервер.

3. Проверьте вывод консоли: Если вы запускаете сервер вручную, проверьте вывод консоли на наличие сообщений об ошибках.

4. Проверьте сетевое подключение: Убедитесь, что ваш компьютер имеет активное подключение к Интернету для доступа к API LCSH.

Лицензия

Этот проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

Для разработчиков

Для получения более подробной документации о реализации сервера, справочных материалов по API и информации о тестировании, пожалуйста, обратитесь к файлу references.md.