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

Related MCP server: MCP Outline Server

Instalación

Clonar el repositorio
Instalar dependencias:

npm install

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 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

Iniciar el servidor:

npm start

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

Construir el proyecto:

npm run build

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:

npm run setup

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)

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

Need Help?

Report Issue

Reddit Discussion

Related Servers

MCP Expert Server