ZenTao MCP

Servicio MCP para la colaboración de desarrollo con ZenTao, que cubre el desglose de requisitos, el plan de ejecución y las sugerencias de asignación de carga de trabajo desde la perspectiva del director, así como el flujo de trabajo de tareas y errores desde la perspectiva del desarrollador.

Estado actual

Actualmente en la fase de desarrollo Phase 1, ya se proporcionan herramientas de diagnóstico de conexión y consulta de solo lectura:

• diagnose_connection

• list_projects

• list_executions

• list_products

• list_stories

• list_tasks

• list_execution_tasks

• list_my_tasks

• list_user_tasks

• list_bugs

• list_my_bugs

• list_user_bugs

• list_users

• get_task

• get_story

• get_bug

list_stories y list_bugs requieren el ID de producto de ZenTao para acceder a los requisitos y errores del producto respectivamente. El agente puede llamar primero a list_users y luego usar el account devuelto para llamar a list_user_tasks o list_user_bugs, sin necesidad de que el usuario introduzca el nombre de usuario manualmente.

Las herramientas de escritura actualmente solo generan un plan por defecto, no ejecutan la solicitud. Solo se envía la solicitud de escritura si se pasa explícitamente confirm: true:

• create_task

• assign_task

• start_task

• finish_task

• complete_task (adecuado para instrucciones en lenguaje natural como "marcar 1554 como completado")

• resolve_bug

Las pruebas y las llamadas normales no deben usar confirm: true.

Related MCP server: zentao-mcp-server

Ejecución local

Copy-Item .env.example .env
npm install
npm run check
npm test
npm run build
npm start

Por defecto, la conexión a ZenTao se configura a través del directorio de usuario: ~/.zentao-mcp/config.json (en Windows, %USERPROFILE%\\.zentao-mcp\\config.json). Ejemplo:

{
  "baseUrl": "https://your-zentao.example.com",
  "apiPath": "/zentao/api.php/v1",
  "token": "your-token",
  "timeoutMs": 10000
}

La variable de entorno ZENTAO_CONFIG_FILE puede especificar la ruta del archivo de configuración; las variables ZENTAO_* solo se usan como método avanzado de anulación/complemento. No escriba credenciales reales en el repositorio.