MCP Expert Server

MCP Expert Server

Un servidor de Model Context Protocol que proporciona generación inteligente de consultas y asistencia de documentación mediante Claude AI. El servidor analiza la documentación de tu API y ofrece dos herramientas principales:

• create-query: Genera consultas basadas en solicitudes en lenguaje natural
• documentation: Proporciona información relevante de la documentación según las preguntas

Requisitos previos

• Node.js >= 18
• Una clave de API de Anthropic para Claude

Instalación

1. Clona el repositorio
2. Instala las dependencias:

npm install

3. Crea un archivo .env con tu clave de API de Anthropic:

ANTHROPIC_API_KEY=your_api_key_here

Configuración

Antes de ejecutar el servidor, necesitas:

1. Compilar el proyecto y ejecutar el script de configuración:

npm run build
npm run setup

Esto hará lo siguiente:

• Crear los directorios requeridos (docs/ y prompts/)
• Crear los archivos de prompt predeterminados
• Generar una descripción inicial del servicio

2. Agrega tus archivos de documentación de API al directorio docs/ (admite archivos .txt, .md y .json)

3. Opcionalmente, personaliza los prompts en el directorio prompts/:

   • system-prompt.txt: Prompt principal del sistema para Claude
   • tool-metadata.txt: Contexto adicional para las descripciones de herramientas
   • query-metadata.txt: Contexto adicional para la generación de consultas
   • service-description.txt: Descripción del servicio generada automáticamente

Uso

Servidor independiente

Inicia el servidor:

npm start

El servidor expone dos herramientas a través del Model Context Protocol:

• create-query: Genera una consulta basada en una solicitud en lenguaje natural

  {
    "name": "create-query",
    "arguments": {
      "request": "Find all users who signed up in the last week"
    }
  }
  

• documentation: Obtiene información de la documentación

  {
    "name": "documentation",
    "arguments": {
      "request": "How do I authenticate API requests?"
    }
  }
  

Integración con Claude Desktop

1. Agrega esta configuración a tu archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "expert": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/expert-server/build/index.js"],
      "env": {
        "ANTHROPIC_API_KEY": "your_api_key_here"
      }
    }
  }
}

2. Reemplaza /ABSOLUTE/PATH/TO/expert-server con la ruta absoluta real a tu instalación del servidor.

3. Reinicia Claude Desktop.

Estructura de directorios

.
├── docs/                  # Your API documentation files
├── prompts/              # System prompts and metadata
│   ├── system-prompt.txt    # Main system prompt
│   ├── tool-metadata.txt    # Tool description context
│   ├── query-metadata.txt   # Query generation context
│   └── service-description.txt  # Generated service description
├── src/                  # Source code
│   ├── index.ts            # Entry point
│   ├── server.ts           # MCP server implementation
│   └── services/           # Core services
│       └── expertService.ts  # Claude integration
└── package.json

Desarrollo

• Compila el proyecto:

npm run build

• El servidor utiliza TypeScript y sigue una arquitectura modular
• Todas las interacciones con Claude son gestionadas por la clase ExpertService
• Los registros de depuración se escriben en stderr con el prefijo [DEBUG]

Solución de problemas

Si encuentras problemas de conexión:

1. Asegúrate de haber ejecutado el script de configuración:

npm run setup

2. Verifica que todos los archivos requeridos existan en el directorio prompts/
3. Confirma que tu ANTHROPIC_API_KEY esté configurado correctamente
4. Usa rutas absolutas en tu configuración de Claude Desktop
5. Revisa los registros de depuración (escritos en stderr)

Variables de entorno

• ANTHROPIC_API_KEY: Tu clave de API de Anthropic (requerida)

Licencia

MIT