Servidores MCP
Una implementación de servidor basada en TypeScript para el Protocolo de contexto de modelo (MCP) que proporciona herramientas de integración para varios servicios como JIRA y la gestión de TODO.
🚀 Características
- Integración de múltiples herramientas : arquitectura modular que admite integraciones de múltiples herramientas
- Seguridad de tipos : compatibilidad total con TypeScript y validación de esquemas Zod
- Soporte ESM : Implementación de módulos ES modernos
- Extensible : Fácil de agregar nuevas herramientas e integraciones
📦 Herramientas actuales
Integración con JIRA
- Crear problemas con campos personalizables
- Formato de respuesta automática
- Validación de esquemas para la creación de problemas
Gestión de TODO
- Crear tareas pendientes con prioridad y fechas de vencimiento
- Esquema flexible que admite campos opcionales
- Mensajes de respuesta formateados
🛠 Estructura del proyecto
src/
├── config/ # Tool configurations
│ ├── jira-tool.config.ts
│ └── todo-tool.config.ts
├── constant/ # Constant definitions
│ └── tool-name.ts
├── schema/ # Zod schemas for validation
│ ├── jira.ts
│ └── todo.ts
├── server/ # Server management
│ └── mcp-server-tool-manager.ts
├── tools/ # Tool implementations
│ ├── jira/
│ │ └── create-issue.ts
│ └── todo/
│ └── create-todo.ts
└── index.ts # Main entry point
🔌 Agregar nuevas herramientas
- Define las constantes de la herramienta en
constant/tool-name.ts - Crear un esquema en el directorio
schema/ - Implementar el controlador de herramientas en el directorio
tools/ - Agregar configuración en el directorio
config/ - Registrar herramienta en
index.ts
Ejemplo:
// 1. Add constant
export const NEW_TOOL = {
ACTION: "action_name"
} as const;
// 2. Create schema
export const newToolSchema = z.object({
// ... schema definition
});
// 3. Implement handler
export const handleAction = async (
args: z.infer<typeof newToolSchema>,
extra: RequestHandlerExtra
): Promise<CallToolResult> => {
// ... implementation
};
// 4. Add configuration
export const newToolConfig = {
name: "New Tool",
version: "1.0.0",
tools: [
{
name: NEW_TOOL.ACTION,
schema: newToolSchema,
handler: handleAction,
},
],
};
🔄 Flujo de trabajo de desarrollo
- Crear rama de características
- Implementar cambios
- Ejecutar pruebas (cuando se implementen)
- Proyecto de construcción
- Presentar PR
📝 Notas
- Utiliza módulos ES para una mejor modularidad
- Implementa el Protocolo de Contexto de Modelo para la comunicación estandarizada
- Sigue las mejores prácticas de TypeScript
- Validación del esquema Zod para seguridad de tipos
🛣️ Hoja de ruta
- [ ] Agregar más operaciones de JIRA
- [ ] Implementar la persistencia TODO
- [ ] Agregar autenticación
- [ ] Agregar marco de pruebas
- [ ] Agregar más integraciones (GitHub, Slack, etc.)
📄 Licencia
Instituto Tecnológico de Massachusetts (MIT)