{"_id":"@dekalabs-npm/taiga-mcp-server","_rev":"7-b74da5c1b43e278b39c288d71ac1c678","name":"@dekalabs-npm/taiga-mcp-server","dist-tags":{"latest":"0.0.3"},"versions":{"0.0.0":{"name":"@dekalabs-npm/taiga-mcp-server","version":"0.0.0","keywords":["mcp","taiga","model-context-protocol","typescript"],"author":"","license":"MIT","_id":"@dekalabs-npm/taiga-mcp-server@0.0.0","maintainers":[{"name":"dekalabs","email":"frontend@dekalabs.com"}],"bin":{"taiga-mcp-server":"dist/index.js"},"dist":{"shasum":"17f126246a356e37fb78f2ed485a75068f6acd82","tarball":"https://registry.npmjs.org/@dekalabs-npm/taiga-mcp-server/-/taiga-mcp-server-0.0.0.tgz","fileCount":159,"integrity":"sha512-uhNiInxKouWE21Teb9hjzxK6zXNJXVrVB9lHYH+NKD1X8ytcOljLm0ANJrgBUlg66ZE5JXIpbzd7iXUiIaYh4Q==","signatures":[{"sig":"MEUCIATAC8hqgIzQ+1dHEzacVUkQL2nfmOWOIHbPp6OR3GZJAiEA3IvJJgBBZkY3YZiXVu6a0x4k9neO6g/HhVqojN2kXVw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":256057},"main":"dist/index.js","type":"module","_from":"file:dekalabs-npm-taiga-mcp-server-0.0.0.tgz","types":"dist/index.d.ts","engines":{"node":">=20.0.0"},"scripts":{"dev":"tsc && node dist/index.js","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js","watch":"tsc --watch","git:tag":"git commit -am \"v$npm_package_version\" && git push origin develop && pnpm git:tag:only","publish:npm":"pnpm run build && pnpm publish --access public","git:tag:only":"git tag v$npm_package_version && git push origin v$npm_package_version"},"_npmUser":{"name":"dekalabs","email":"frontend@dekalabs.com"},"_resolved":"/tmp/9e8d7e2ae9c0b871a5d7ef4a845cd34c/dekalabs-npm-taiga-mcp-server-0.0.0.tgz","_integrity":"sha512-uhNiInxKouWE21Teb9hjzxK6zXNJXVrVB9lHYH+NKD1X8ytcOljLm0ANJrgBUlg66ZE5JXIpbzd7iXUiIaYh4Q==","_npmVersion":"11.9.0","description":"MCP Server para interactuar con la API de Taiga","directories":{},"_nodeVersion":"24.14.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/taiga-mcp-server_0.0.0_1773137812759_0.18537042328391506","host":"s3://npm-registry-packages-npm-production"}},"0.0.1":{"name":"@dekalabs-npm/taiga-mcp-server","version":"0.0.1","keywords":["mcp","taiga","model-context-protocol","typescript"],"author":"","license":"MIT","_id":"@dekalabs-npm/taiga-mcp-server@0.0.1","maintainers":[{"name":"dekalabs","email":"frontend@dekalabs.com"}],"bin":{"taiga-mcp-server":"dist/index.js"},"dist":{"shasum":"f559d813301e401f11d9e5666ac83d49a182e242","tarball":"https://registry.npmjs.org/@dekalabs-npm/taiga-mcp-server/-/taiga-mcp-server-0.0.1.tgz","fileCount":131,"integrity":"sha512-kNKNAwXtmjoPkBjBHOeo0O0j2ngpb65x/LGK4Y7XKGeoleIZADXL5Z4YgmFTIficopKVZbmsgfrV7rmb0L53eA==","signatures":[{"sig":"MEYCIQD0wfK0SiMY50gfgwszDE7JsN6Y5NaCfVPbWnWOW6PV+AIhAOunWVCIsfc1D4xAHQfPt5dFEItSHQEVdykorOZqIjMo","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":219839},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.0.0"},"gitHead":"4b352f5adef02106641cf23d7ddfc7eb1ce7a113","scripts":{"dev":"tsc && node dist/index.js","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js","watch":"tsc --watch","git:tag":"git commit -am \"v$npm_package_version\" && git push origin develop && pnpm git:tag:only","publish:npm":"pnpm run build && pnpm publish --access public","git:tag:only":"git tag v$npm_package_version && git push origin v$npm_package_version"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:aca79d19-e005-4685-9198-26c60ff18b2c"}},"_npmVersion":"11.9.0","description":"MCP Server para interactuar con la API de Taiga","directories":{},"_nodeVersion":"24.14.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/taiga-mcp-server_0.0.1_1773137925302_0.011065514775867369","host":"s3://npm-registry-packages-npm-production"}},"0.0.2":{"name":"@dekalabs-npm/taiga-mcp-server","version":"0.0.2","keywords":["mcp","taiga","model-context-protocol","typescript"],"author":"","license":"MIT","_id":"@dekalabs-npm/taiga-mcp-server@0.0.2","maintainers":[{"name":"dekalabs","email":"frontend@dekalabs.com"}],"bin":{"taiga-mcp-server":"dist/index.js"},"dist":{"shasum":"25dcb42ea0fadf03da88caf8a5355b43e312dba7","tarball":"https://registry.npmjs.org/@dekalabs-npm/taiga-mcp-server/-/taiga-mcp-server-0.0.2.tgz","fileCount":131,"integrity":"sha512-KAf0jIol/s7oupHMOxp2kwb88+gBoRKsXId0jLhzyGJp0yAfSTg7gtiXpNeux5X/Awla413G+Cc9w+TSbZeX8w==","signatures":[{"sig":"MEUCIEDw9Ay45Xn2wZry6k2q6x7C/1gbl7OnWuF/A9mgfUDQAiEA2YJr9tEvGdbBgrW/HXODkZQnMgFC/HFJDfhDbt6Gp7o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":219945},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.0.0"},"gitHead":"29e37d3d6527bbe518e8a57b7cdbb6401018ccd9","scripts":{"dev":"tsc && node dist/index.js","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js","watch":"tsc --watch","git:tag":"git commit -am \"v$npm_package_version\" && git push origin develop && pnpm git:tag:only","publish:npm":"pnpm run build && pnpm publish --access public","git:tag:only":"git tag v$npm_package_version && git push origin v$npm_package_version"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:aca79d19-e005-4685-9198-26c60ff18b2c"}},"_npmVersion":"11.9.0","description":"MCP Server para interactuar con la API de Taiga","directories":{},"_nodeVersion":"24.14.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/taiga-mcp-server_0.0.2_1773138095270_0.8600616972404815","host":"s3://npm-registry-packages-npm-production"}},"0.0.3":{"name":"@dekalabs-npm/taiga-mcp-server","version":"0.0.3","description":"MCP Server para interactuar con la API de Taiga","type":"module","main":"dist/index.js","types":"dist/index.d.ts","bin":{"taiga-mcp-server":"dist/index.js"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsc && node dist/index.js","watch":"tsc --watch","clean":"rm -rf dist node_modules","reinstall":"pnpm clean && pnpm install","git:tag":"git commit -am \"v$npm_package_version\" && git push origin develop && pnpm git:tag:only","git:tag:only":"git tag v$npm_package_version && git push origin v$npm_package_version","publish:npm":"pnpm run build && pnpm publish --access public"},"keywords":["mcp","taiga","model-context-protocol","typescript"],"author":"","license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@types/node":"^24.0.0","typescript":"^5.3.3"},"engines":{"node":">=24.0.0"},"gitHead":"6e1d857be10ea899e4c1fca9d2de87f9ad9e9755","_id":"@dekalabs-npm/taiga-mcp-server@0.0.3","_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-ZoU39JoXyScRoUaL0IKsggRo7K6EfZsQDgQbjqcNUXlsmggyIHLTO5YSnGojQS1CjLYb2Poq3KPBUE3T65h6cA==","shasum":"81bdde619d66fc2a6a65a4c1195bd1b8ac9d442b","tarball":"https://registry.npmjs.org/@dekalabs-npm/taiga-mcp-server/-/taiga-mcp-server-0.0.3.tgz","fileCount":131,"unpackedSize":220031,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDl5sBd56G55kiaQ6w3nKgV+XvW/6kEm8YkSYfc2KzEfAiEA369nURiG99Xu+H1YeCf1LFG4pu8KqU1ZgXFLjx8w9i0="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:aca79d19-e005-4685-9198-26c60ff18b2c"}},"directories":{},"maintainers":[{"name":"dekalabs","email":"frontend@dekalabs.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/taiga-mcp-server_0.0.3_1773154413755_0.4004579102992418"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-10T10:16:52.645Z","modified":"2026-03-10T14:53:34.060Z","1.0.0":"2026-03-06T09:11:42.733Z","1.0.3":"2026-03-06T09:33:50.108Z","0.0.0":"2026-03-10T10:16:52.949Z","0.0.1":"2026-03-10T10:18:45.455Z","0.0.2":"2026-03-10T10:21:35.413Z","0.0.3":"2026-03-10T14:53:33.911Z"},"license":"MIT","keywords":["mcp","taiga","model-context-protocol","typescript"],"description":"MCP Server para interactuar con la API de Taiga","maintainers":[{"name":"dekalabs","email":"frontend@dekalabs.com"}],"readme":"# Servidor MCP para Taiga\n\nServidor Model Context Protocol (MCP) para interactuar con la API de Taiga desde clientes LLM (Cursor, Open WebUI, Slack MCP, etc.).\n\n## Requisitos\n\n- Node.js 24.x (LTS Krypton, usar `.nvmrc`)\n- Acceso a una instancia de Taiga\n- Autenticación por token o por usuario/contraseña\n\n## Variables de entorno\n\n| Variable | Requerida | Descripción |\n|---|---|---|\n| `TAIGA_API_URL` | Si | URL base de tu instancia Taiga, por ejemplo `https://tu-instancia-taiga.com/api/v1` |\n| `TAIGA_TOKEN` | Si* | Token de autenticación |\n| `TAIGA_USERNAME` | Si* | Usuario de Taiga |\n| `TAIGA_PASSWORD` | Si* | Contraseña de Taiga |\n\n\\* Debes configurar `TAIGA_TOKEN` **o** `TAIGA_USERNAME` + `TAIGA_PASSWORD`.\n\n## Instalacion local\n\n1. Configurar la version de Node.js:\n\n```bash\nnvm use\n```\n\n2. Instalar dependencias:\n\n```bash\npnpm install\n```\n\n3. Compilar:\n\n```bash\npnpm build\n```\n\n4. Configurar variables de entorno:\n\n**Opción A: token directo**\n\n```bash\nexport TAIGA_API_URL=\"https://tu-instancia-taiga.com/api/v1\"\nexport TAIGA_TOKEN=\"tu-token-de-taiga\"\n```\n\n**Opción B: usuario y contraseña**\n\n```bash\nexport TAIGA_API_URL=\"https://tu-instancia-taiga.com/api/v1\"\nexport TAIGA_USERNAME=\"tu-usuario\"\nexport TAIGA_PASSWORD=\"tu-contraseña\"\n```\n\n## Uso desde npm (sin clonar)\n\nPuedes ejecutarlo directamente con `npx`:\n\n```bash\nnpx -y @dekalabs-npm/taiga-mcp-server\n```\n\n## Configuracion en cliente MCP\n\nEste servidor se expone por `stdio` y funciona con clientes MCP compatibles.\nTienes un ejemplo en `mcp.config.example.json`.\n\n### Opción recomendada (con nvm)\n\n```json\n{\n  \"mcpServers\": {\n    \"taiga\": {\n      \"command\": \"bash\",\n      \"args\": [\n        \"-lc\",\n        \"source ~/.nvm/nvm.sh && nvm use >/dev/null && npx -y @dekalabs-npm/taiga-mcp-server\"\n      ],\n      \"env\": {\n        \"TAIGA_API_URL\": \"https://tu-instancia-taiga.com/api/v1\",\n        \"TAIGA_TOKEN\": \"tu-token-de-taiga\"\n      }\n    }\n  }\n}\n```\n\n### Opción con usuario y contraseña\n\n```json\n{\n  \"mcpServers\": {\n    \"taiga\": {\n      \"command\": \"bash\",\n      \"args\": [\n        \"-lc\",\n        \"source ~/.nvm/nvm.sh && nvm use >/dev/null && npx -y @dekalabs-npm/taiga-mcp-server\"\n      ],\n      \"env\": {\n        \"TAIGA_API_URL\": \"https://tu-instancia-taiga.com/api/v1\",\n        \"TAIGA_USERNAME\": \"tu-usuario\",\n        \"TAIGA_PASSWORD\": \"tu-contraseña\"\n      }\n    }\n  }\n}\n```\n\n## Flujo recomendado\n\nAntes de usar cualquier otra herramienta, llama a `load_project_context` con `projectSlug` o `projectId`.\n\n```text\n1. load_project_context({ projectSlug: \"mi-proyecto\" })\n   -> Devuelve estados, roles, puntos, tags y miembros\n2. Usar el resto de herramientas con esos IDs\n```\n\n## Herramientas disponibles\n\n### Contexto y configuracion\n\n- `load_project_context` - Inicializa y devuelve configuracion dinamica del proyecto\n- `get_estimation_taxonomy` - Devuelve roles computables y escala de puntos\n\n### Creacion\n\n- `create_user_story` - Crea una historia de usuario\n- `create_storyless` - Crea una tarea sin historia de usuario\n- `create_task_for_us` - Crea una tarea dentro de una historia de usuario\n\n### Listado\n\n- `list_sprints` - Lista sprints activos\n- `list_users` - Lista usuarios (`GET /api/v1/users`, con filtro opcional por `project`)\n- `list_user_stories` - Lista historias de usuario con filtros avanzados\n- `list_tasks` - Lista tareas con filtros avanzados\n- `list_user_stories_from_sprint` - Lista historias de usuario de un sprint\n- `list_tasks_from_user_story` - Lista tareas de una historia de usuario\n\n### Actualizacion\n\n- `update_user_story_status` - Actualiza estado de historias de usuario\n- `update_task_status` - Actualiza estado de tareas\n- `update_user_story_subject` - Actualiza titulo de una historia de usuario\n- `update_user_story_tags` - Actualiza tags de una historia de usuario\n- `update_user_story_points` - Actualiza puntos por rol de una historia de usuario\n- `move_us_to_sprint` - Mueve una historia a sprint y la pone en READY\n\n### Operaciones masivas\n\n- `generate_backlog` - Crea multiples historias de usuario con tareas\n\n## Parámetros destacados\n\n### `load_project_context`\n\n| Parámetro | Tipo | Requerido | Descripción |\n|---|---|---|---|\n| `projectSlug` | string | Si (o projectId) | Slug del proyecto |\n| `projectId` | number | Si (o projectSlug) | ID numerico del proyecto |\n| `forceRefresh` | boolean | No | Fuerza recarga del contexto |\n\n### `list_users`\n\n| Parámetro | Tipo | Requerido | Descripción |\n|---|---|---|---|\n| `project` | number | No | ID del proyecto. Si no se indica, usa el proyecto del contexto actual |\n\n## Pruebas manuales\n\n```bash\npnpm build && pnpm start\n```\n\nEl servidor se comunica por stdio; para pruebas funcionales es mejor usarlo desde un cliente MCP.\n\n## Estructura del proyecto\n\n```text\n.\n├── .nvmrc\n├── package.json\n├── tsconfig.json\n├── README.md\n├── mcp.config.example.json\n└── src/\n    ├── index.ts\n    ├── config/\n    │   └── constants.ts\n    ├── client/\n    │   ├── TaigaClient.ts\n    │   └── TaigaAuth.ts\n    ├── types/\n    │   └── taiga.ts\n    ├── utils/\n    │   └── guardrails.ts\n    └── tools/\n        ├── index.ts\n        ├── loadProjectContext.ts\n        ├── listUsers.ts\n        ├── createUserStory.ts\n        ├── createStoryless.ts\n        ├── createTaskForUs.ts\n        ├── listSprints.ts\n        ├── listUserStories.ts\n        ├── listTasks.ts\n        ├── listUserStoriesFromSprint.ts\n        ├── listTasksFromUserStory.ts\n        ├── updateUserStoryStatus.ts\n        ├── updateTaskStatus.ts\n        ├── updateUserStorySubject.ts\n        ├── updateUserStoryTags.ts\n        ├── updateUserStoryPoints.ts\n        ├── moveUsToSprint.ts\n        ├── generateBacklog.ts\n        └── modules/\n            ├── index.ts\n            ├── configTools.ts\n            ├── createTools.ts\n            ├── listTools.ts\n            ├── updateTools.ts\n            ├── bulkTools.ts\n            └── toolHandlers.ts\n```\n\n## Scripts\n\n- `pnpm build` - Compila TypeScript a JavaScript\n- `pnpm start` - Ejecuta el servidor compilado\n- `pnpm dev` - Compila y ejecuta en un solo paso\n- `pnpm watch` - Watch mode\n- `pnpm clean` - Limpia `dist`\n\n## Notas importantes\n\n1. `load_project_context` debe llamarse al inicio de cada sesion.\n2. El contexto del proyecto se cachea en memoria (estados, roles, puntos, tags, miembros).\n3. El servidor usa control de version optimista de Taiga en operaciones PATCH.\n\n## Soporte\n\nSi necesitas soporte técnico con este proyecto, contacta a Luis Ballester Zafra - Dekalabs.\n\n## Troubleshooting\n\n1. Verifica que `TAIGA_API_URL` y las credenciales estén configuradas.\n2. Revisa logs de error en stderr.\n3. Asegura Node.js 24.x (LTS Krypton).\n4. Verifica dependencias instaladas con `pnpm install`.\n5. Asegurate de llamar `load_project_context` antes de otras herramientas.\n","readmeFilename":"README.md"}