LDIMS MCP

Proporciona una interfaz MCP para el sistema de gestión de documentos LDIMS.

Documentación

Herramientas de Scripts de LDIMS MCP

Este directorio contiene herramientas de scripts útiles para el servicio LDIMS MCP.

🚀 Métodos de Ejecución

Método 1: Modo MCP (Recomendado)

Se invoca a través del cliente MCP, el Token se configura en el cliente MCP:

# 编译
npm run build

# MCP客户端会自动调用 node dist/index.js
# Token通过MCP配置传递，不需要.env文件中的LDIMS_AUTH_TOKEN

Método 2: Modo HTTP (Adecuado para pruebas e integración)

Inicia un servidor HTTP independiente, utilizando la configuración del archivo .env:

# 确保.env文件中配置了LDIMS_AUTH_TOKEN
npm run http

# 或直接运行
node dist/http-server.js

🔐 Explicación del modo de doble Token:

Modo MCP: Utiliza el Token de la configuración del cliente MCP
Modo HTTP: Utiliza LDIMS_AUTH_TOKEN del archivo .env
Los dos modos se configuran de forma independiente, sin interferir entre sí

🚀 Inicio Rápido

Proceso de Implementación Completo

Generar Token de larga duración
```
node scripts/get-long-term-token.js
```
Compilar el proyecto
```
npm run build
```
Probar la conexión API
```
node scripts/test-api-connection.js
```
Configurar la herramienta de IA - Consulte la sección "Configuración de registro del servicio MCP" a continuación
Reiniciar la herramienta de IA - Reinicie Cursor o Claude Desktop para cargar la nueva configuración

📋 Descripción de Scripts

🔑 Scripts de Gestión de Token

`get-fresh-token.js`

Genera un nuevo Token de autenticación (válido por 24 horas)

node scripts/get-fresh-token.js

`get-long-term-token.js`

Genera un Token de autenticación de larga duración (válido por aproximadamente 7.5 años)

node scripts/get-long-term-token.js

`update-env-token.js`

Actualiza la configuración del Token en el archivo de entorno

node scripts/update-env-token.js <new_token>

🧪 Scripts de Prueba

`test-api-connection.js`

Prueba exhaustiva de la conexión y funcionalidad de la API de LDIMS

node scripts/test-api-connection.js

Contenido de la prueba:

✅ Verificación de salud
✅ Función de búsqueda de documentos
✅ Función de obtención de contenido de documentos
✅ Tiempo de respuesta de la API y calidad de los datos

🚀 Casos de Uso

Implementación Inicial

Ejecute get-long-term-token.js para generar un Token de larga duración
Ejecute test-api-connection.js para verificar la conexión API
Registre el servicio MCP en la herramienta de IA (consulte las instrucciones de configuración a continuación)

Manejo de Token Expirado

Ejecute get-fresh-token.js o get-long-term-token.js para generar un nuevo Token
Ejecute update-env-token.js para actualizar el archivo de configuración
Reinicie el servicio MCP

Pruebas de Funcionalidad

Ejecute test-api-connection.js para realizar una prueba exhaustiva
Revise los resultados de la prueba para asegurarse de que todas las funciones funcionan correctamente

🔧 Configuración de Registro del Servicio MCP

Configuración en Cursor

Agregue la siguiente configuración en el archivo de configuración MCP de Cursor:

Ubicación del archivo de configuración:

Windows: %APPDATA%\Cursor\User\globalStorage\cursor.mcp\config.json
macOS: ~/Library/Application Support/Cursor/User/globalStorage/cursor.mcp/config.json
Linux: ~/.config/Cursor/User/globalStorage/cursor.mcp/config.json

{
  "ldims": {
    "command": "node",
    "args": ["D:/DEV/LDIMS/backend_mcp/dist/index.js"],
    "env": {
      "LDIMS_API_BASE_URL": "http://localhost:3000",
      "LDIMS_API_VERSION": "v1",
      "LDIMS_AUTH_TOKEN": "your_long_term_token_here",
      "NODE_ENV": "production"
    }
  }
}

Configuración en Claude Desktop

Ubicación del archivo de configuración:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Agregue lo siguiente en el archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "ldims": {
      "command": "node",
      "args": ["D:/DEV/LDIMS/backend_mcp/dist/index.js"],
      "env": {
        "LDIMS_API_BASE_URL": "http://localhost:3000",
        "LDIMS_API_VERSION": "v1",
        "LDIMS_AUTH_TOKEN": "your_long_term_token_here",
        "NODE_ENV": "production"
      }
    }
  }
}

Notas de Configuración

command: Utilice el comando node para ejecutar el archivo JavaScript compilado
args: Apunta a la ruta absoluta del archivo dist/index.js compilado
LDIMS_API_BASE_URL: Utilice una dirección HTTP, no una ruta de archivo (por ejemplo: http://localhost:3000)
LDIMS_AUTH_TOKEN: Utilice el Token de larga duración generado por get-long-term-token.js
NODE_ENV: Establézcalo en production para obtener el mejor rendimiento

⚠️ Recordatorio importante:

Las rutas deben ser rutas absolutas, ajústelas según su ubicación de instalación real
Asegúrese de ejecutar primero npm run build para compilar el proyecto
Asegúrese de que el servicio backend de LDIMS se ejecute en http://localhost:3000

⚠️ Notas Importantes

Asegúrese de que el servicio backend de LDIMS esté en ejecución
La generación de Token requiere una conexión de base de datos válida
Los scripts de prueba requieren código compilado (ejecute primero npm run build)
Todos los scripts leen el archivo .env en el directorio raíz del proyecto

📞 Solución de Problemas

Si los scripts fallan al ejecutarse:

Verifique el estado del servicio backend de LDIMS
Verifique la conexión de la base de datos
Confirme la configuración de las variables de entorno
Revise los mensajes de error de la consola

🔧 Notas de Desarrollo

Estos scripts son herramientas centrales del proyecto, no los modifique sin necesidad. Si necesita agregar nuevas funciones:

Siga el estilo de código existente
Agregue un manejo de errores adecuado
Actualice este documento README