servidor mcp cataloger

Un servidor del Protocolo de Contexto de Modelo (MCP) que proporciona acceso a los Encabezamientos de Materia de la Biblioteca del Congreso (LCSH) a través de una interfaz API sencilla.

Descripción general

Este servidor MCP permite a asistentes de IA como Claude buscar en los Encabezamientos de Materia de la Biblioteca del Congreso (LCSH) utilizando la API pública suggest2. Proporciona una interfaz limpia para consultar datos de LCSH y manejar los diversos formatos de respuesta de la API.

Related MCP server: MeSH MCP

Instalación

Opción 1: Instalar desde PyPI (Recomendado)

La forma más sencilla de instalar el servidor mcp cataloger es directamente desde PyPI:

pip install cataloger-mcp-server

Opción 2: Instalar desde el código fuente

Si prefieres instalar desde el código fuente:

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

Configuración con Claude Desktop

1. Instala Claude Desktop si aún no lo has hecho desde https://claude.ai/desktop

2. Instala el servidor mcp cataloger utilizando uno de los métodos de instalación anteriores

3. Abre Claude Desktop y navega a Configuración (Settings):

   • Haz clic en tu foto de perfil en la esquina inferior izquierda

   • Selecciona "Settings" en el menú

4. Configura el servidor MCP:

   • En el panel de Configuración, haz clic en "MCP Servers"

   • Haz clic en "Add Server"

   • Rellena los siguientes detalles:

     • Name: cataloger mcp search

     • Command: cataloger-mcp-server

   • Haz clic en "Save"

5. Habilita el servidor:

   • Activa el interruptor junto al servidor cataloger mcp search para habilitarlo

   • Claude ahora tendrá acceso a las capacidades de búsqueda de LCSH

Configuración con Cherry Studio

1. Instala Cherry Studio siguiendo las instrucciones en la documentación de Cherry: https://docs.cherry-ai.com/docs/en-us/advanced-basic/mcp/install

2. Instala el servidor mcp cataloger utilizando uno de los métodos de instalación anteriores.

3. Prepara la configuración JSON de MCP para Cherry Studio. Utiliza el método "Import JSON" con un fragmento como:

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

   • Puedes cambiar la clave "cataloger-mcp" por la etiqueta que prefieras en Cherry Studio.

4. Importar a Cherry Studio:

   • Abre Cherry Studio y ve a Settings → MCP (o MCP Servers).

   • Haz clic en Add / Import from JSON (la redacción puede variar ligeramente según la versión).

   • Pega el fragmento JSON anterior y confirma para añadir el servidor.

5. Verifica el servidor:

   • Asegúrate de que la nueva entrada cataloger-mcp-server aparezca en la lista de MCP y esté habilitada.

   • Inicia un nuevo chat y confirma que Cherry Studio puede llamar a las herramientas MCP de cataloger.

Uso del servidor mcp cataloger con Claude

Una vez que el servidor esté configurado y habilitado en Claude Desktop, puedes pedirle a Claude que busque en los Encabezamientos de Materia de la Biblioteca del Congreso. Aquí tienes algunos ejemplos de prompts:

• "¿Puedes buscar 'artificial intelligence' en los Encabezamientos de Materia de la Biblioteca del Congreso?"

• "Busca 'climate change' en LCSH y dime cuáles son los encabezamientos de materia oficiales."

• "¿Cuáles son los términos LCSH relacionados con 'quantum computing'?"

Claude utilizará el servidor MCP para consultar las bases de datos LCSH y LCNAF y devolver los resultados.

• "Encuentra el registro de autoridad de nombre para 'Smith, John Adam'."

• "Realiza una búsqueda por palabras clave en LCSH para 'environmental policy'."

Características

• Integración de herramientas MCP: Expone las herramientas search_lcsh (para encabezamientos de materia, búsqueda predeterminada anclada a la izquierda), search_lcsh_keyword (para encabezamientos de materia, búsqueda por palabras clave) y search_name_authority (para nombres personales) que pueden ser utilizadas por asistentes de IA.

• Endpoints de recursos: Proporciona endpoints de recursos en lcsh://search/{query} y lcnaf://search/{query}.

• Manejo robusto de errores: Maneja con elegancia los errores de la API, problemas de conexión y formatos de respuesta inesperados.

• Múltiples formatos de respuesta: Admite formatos de respuesta tanto de diccionario (hits) como de lista desde la API de LCSH.

Solución de problemas

Si encuentras problemas con el servidor MCP:

1. Comprueba el estado del servidor: En Claude Desktop, ve a Settings > MCP Servers y comprueba si el servidor está habilitado y en ejecución.

2. Reinicia el servidor: Apaga y vuelve a encender el servidor.

3. Comprueba la salida de la consola: Si ejecutas el servidor manualmente, comprueba la salida de la consola para ver si hay mensajes de error.

4. Verifica la conexión de red: Asegúrate de que tu ordenador tenga una conexión a Internet activa para acceder a la API de LCSH.

Licencia

Este proyecto está bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.

Para desarrolladores

Para obtener documentación más detallada sobre la implementación del servidor, referencias de la API e información de pruebas, consulta el archivo references.md.