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

Related MCP server: JIRA MCP Server

📦 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

1. Define las constantes de la herramienta en constant/tool-name.ts

2. Crear un esquema en el directorio schema/

3. Implementar el controlador de herramientas en el directorio tools/

4. Agregar configuración en el directorio config/

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

1. Crear rama de características

2. Implementar cambios

3. Ejecutar pruebas (cuando se implementen)

4. Proyecto de construcción

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