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

1. Clonar el repositorio

2. Instalar dependencias:

npm install

3. 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:

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

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

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

1. 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"
      }
    }
  }
}

2. Reemplace /ABSOLUTE/PATH/TO/expert-server con la ruta absoluta real a la instalación de su servidor.

3. 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:

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

npm run setup

2. Compruebe que todos los archivos necesarios existan en el directorio prompts/

3. Verifique que su ANTHROPIC_API_KEY esté configurada correctamente

4. Utilice rutas absolutas en su configuración de Claude Desktop

5. 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)