Servidor experto MCP
Un servidor de Protocolo de Contexto de Modelo que proporciona generación inteligente de consultas y asistencia con la documentación mediante Claude AI. El servidor analiza la documentación de la API y proporciona dos herramientas principales:
- create-query : genera consultas basadas en solicitudes de lenguaje natural
- Documentación : Proporciona información de documentación relevante en función de las preguntas.
Prerrequisitos
- Node.js >= 18
- Una clave API antrópica para Claude
Instalación
- Clonar el repositorio
- Instalar dependencias:
- Cree un archivo
.env con su clave API de Anthropic:
ANTHROPIC_API_KEY=your_api_key_here
Configuración
Antes de ejecutar el servidor, debe:
- Construya el proyecto y ejecute el script de instalación:
npm run build
npm run setup
Esto hará lo siguiente:
- Cree los directorios necesarios (
docs/ y prompts/ ) - Crear archivos de aviso predeterminados
- Generar una descripción inicial del servicio
- Agregue los archivos de documentación de su API al directorio
docs/ (admite archivos .txt , .md y .json ) - Opcionalmente, personalice las indicaciones en el directorio
prompts/ :system-prompt.txt : Indicador principal del sistema para Claudetool-metadata.txt : contexto adicional para las descripciones de herramientasquery-metadata.txt : contexto adicional para la generación de consultasservice-description.txt : Descripción del servicio generada automáticamente
Uso
Servidor independiente
Iniciar el servidor:
El servidor expone dos herramientas a través del Protocolo de Contexto de Modelo:
- 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"
}
}
- documentación : Obtenga información de la documentación
{
"name": "documentation",
"arguments": {
"request": "How do I authenticate API requests?"
}
}
Integración de escritorio de Claude
- Agregue esta configuración a su 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"
}
}
}
}
- Reemplace
/ABSOLUTE/PATH/TO/expert-server con la ruta absoluta real a la instalación de su servidor. - Reinicie Claude Desktop.
Estructura del directorio
.
├── 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
- El servidor utiliza TypeScript y sigue una arquitectura modular.
- Todas las interacciones de Claude son manejadas por la clase ExpertService
- Los registros de depuración se escriben en stderr con el prefijo [DEBUG]
Solución de problemas
Si encuentra problemas de conexión:
- Asegúrese de haber ejecutado el script de configuración:
- Compruebe que todos los archivos necesarios existan en el directorio
prompts/ - Verifique que su
ANTHROPIC_API_KEY esté configurada correctamente - Utilice rutas absolutas en su configuración de Claude Desktop
- Verifique los registros de depuración (escritos en stderr)
Variables de entorno
ANTHROPIC_API_KEY : Su clave de API antrópica (obligatoria)
Licencia
Instituto Tecnológico de Massachusetts (MIT)