Servidor MCP de NeoDB

Implementación de un servidor de Protocolo de Control de Mensajes (MCP) para interactuar con NeoDB , un servicio de catalogación social de libros. Este servidor proporciona herramientas para obtener información del usuario, buscar libros y recuperar información detallada de los mismos mediante la API de NeoDB.

Configuración

Instalar UV

Primero, instale el instalador del paquete UV:

curl -LsSf https://astral.sh/uv/install.sh | sh

Crear entorno virtual

Cree y active un entorno virtual de Python usando UV:

uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate     # On Windows

Instalar dependencias

Instalar dependencias del proyecto usando UV:

uv pip install .

Related MCP server: Yonote MCP Server

Herramientas disponibles

El servidor proporciona las siguientes herramientas:

1. obtener información del usuario

   • Obtiene la información básica del usuario actual

   • No se requieren parámetros

2. libros de búsqueda

   • Busca artículos en el catálogo

   • Parámetros:

     • query (cadena): consulta de búsqueda de libros

3. obtener libro

   • Obtiene información detallada sobre un libro específico

   • Parámetros:

     • book_id (cadena): El ID del libro a recuperar

Uso con Claude Desktop

Obtener token de acceso

Hay dos formas de obtener su token de acceso:

1. Usando la guía oficial: Sigue la documentación oficial para obtener tu token de acceso.

2. Uso de un script automatizado: puede utilizar el script neodb-get-access-token que proporciona una forma simplificada de obtener su token de acceso.

Actualizar configuración claude_desktop_config.json

{
  "mcpServers": {
    "neodb": {
      "command": "uv",
      "args": [
        "--directory",
        "<PATH_TO_PROJECT_DIR>",
        "run",
        "<PATH_TO_SCRIPT>",
        "<API_BASE> e.g. https://neodb.social",
        "<ACCESS_TOKEN>"
      ]
    }
  }
}

Dónde:

• <API_BASE> : La URL base para la API de NeoDB

• <ACCESS_TOKEN> : Su token de acceso a la API de NeoDB

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.