Mentor MCP

mentor-mcp-server

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona a los Agentes LLM una segunda opinión mediante capacidades de mentoría impulsadas por IA con Deepseek-Reasoning (R1), incluyendo revisión de código, crítica de diseño, retroalimentación de escritura y lluvia de ideas a través de la API de Deepseek. Prepara a tu Agente LLM para el éxito con segundas opiniones expertas e información práctica.

Protocolo de Contexto de Modelo

El Protocolo de Contexto de Modelo (MCP) permite la comunicación entre:

• Clientes: Claude Desktop, IDEs y otros clientes compatibles con MCP
• Servidores: Herramientas y recursos para gestión de tareas y automatización
• Agentes LLM: Modelos de IA que aprovechan las capacidades del servidor

Tabla de Contenidos

• Características
• Instalación
• Configuración
• Herramientas
• Ejemplos
• Desarrollo
• Estructura del Proyecto
• Licencia

Características

Análisis de Código

• Revisiones integrales de código
• Detección y prevención de errores
• Evaluación de estilo y mejores prácticas
• Sugerencias de optimización de rendimiento
• Evaluación de vulnerabilidades de seguridad

Diseño y Arquitectura

• Críticas de diseño UI/UX
• Análisis de diagramas arquitectónicos
• Recomendaciones de patrones de diseño
• Evaluación de accesibilidad
• Verificaciones de consistencia

Mejora de Contenido

• Retroalimentación y mejora de escritura
• Análisis de gramática y estilo
• Revisión de documentación
• Evaluación de claridad del contenido
• Recomendaciones estructurales

Planificación Estratégica

• Lluvia de ideas para mejoras de funciones
• Segundas opiniones sobre enfoques
• Sugerencias de innovación
• Análisis de viabilidad
• Evaluación del valor para el usuario

Instalación

# Clone the repository
git clone git@github.com:cyanheads/mentor-mcp-server.git
cd mentor-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Configuración

Agrega a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "mentor": {
      "command": "node",
      "args": ["build/index.js"],
      "env": {
        "DEEPSEEK_API_KEY": "your_api_key",
        "DEEPSEEK_MODEL": "deepseek-reasoner",
        "DEEPSEEK_MAX_TOKENS": "8192",
        "DEEPSEEK_MAX_RETRIES": "3",
        "DEEPSEEK_TIMEOUT": "30000"
      }
    }
  }
}

Variables de Entorno

Variable	Requerida	Predeterminada	Descripción
DEEPSEEK_API_KEY	Sí	-	Tu clave de API de Deepseek
DEEPSEEK_MODEL	Sí	deepseek-reasoner	Nombre del modelo Deepseek
DEEPSEEK_MAX_TOKENS	No	8192	Máximo de tokens por solicitud
DEEPSEEK_MAX_RETRIES	No	3	Número de intentos de reintento
DEEPSEEK_TIMEOUT	No	30000	Tiempo de espera de solicitud (ms)

Herramientas

Revisión de Código

<use_mcp_tool>
<server_name>mentor-mcp-server</server_name>
<tool_name>code_review</tool_name>
<arguments>
{
  "file_path": "src/app.ts",
  "language": "typescript"
}
</arguments>
</use_mcp_tool>

Crítica de Diseño

<use_mcp_tool>
<server_name>mentor-mcp-server</server_name>
<tool_name>design_critique</tool_name>
<arguments>
{
  "design_document": "path/to/design.fig",
  "design_type": "web UI"
}
</arguments>
</use_mcp_tool>

Retroalimentación de Escritura

<use_mcp_tool>
<server_name>mentor-mcp-server</server_name>
<tool_name>writing_feedback</tool_name>
<arguments>
{
  "text": "Documentation content...",
  "writing_type": "documentation"
}
</arguments>
</use_mcp_tool>

Mejora de Funciones

<use_mcp_tool>
<server_name>mentor-mcp-server</server_name>
<tool_name>brainstorm_enhancements</tool_name>
<arguments>
{
  "concept": "User authentication system"
}
</arguments>
</use_mcp_tool>

Ejemplos

Ejemplos detallados del uso y salida de cada herramienta se pueden encontrar en el directorio ejemplos:

• Ejemplo de Segunda Opinión - Análisis de requisitos del sistema de autenticación
• Ejemplo de Revisión de Código - Revisión detallada de código TypeScript con información de seguridad y rendimiento
• Ejemplo de Crítica de Diseño - Retroalimentación integral de UI/UX para un diseño de panel de control
• Ejemplo de Retroalimentación de Escritura - Sugerencias de mejora de documentación
• Ejemplo de Lluvia de Ideas para Mejoras - Ideación de funciones con detalles de implementación

Cada ejemplo incluye el formato de solicitud y la respuesta de muestra, demostrando las capacidades de la herramienta y la estructura de salida.

Desarrollo

# Build TypeScript code
npm run build

# Start the server
npm run start

# Development with watch mode
npm run dev

# Clean build artifacts
npm run clean

Estructura del Proyecto

src/
├── api/         # API integration modules
├── tools/       # Tool implementations
│   ├── second-opinion/
│   ├── code-review/
│   ├── design-critique/
│   ├── writing-feedback/
│   └── brainstorm-enhancements/
├── types/       # TypeScript type definitions
├── utils/       # Utility functions
├── config.ts    # Server configuration
├── index.ts     # Entry point
└── server.ts    # Main server implementation

Licencia

Licencia Apache 2.0. Consulta LICENCIA para más información.

---