Serveur MCP codecks-cli
Commit 14 nov. 2026Permet à un agent IA de gérer les tableaux de projet Codecks.io en créant des cartes, en animant des standups et en structurant les tâches de développement de jeux.
Aussi connu sous rangogamedev/codecks-cli
- Étoiles
- 6
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 14 nov. 2026
- Licence
- MIT
Qu'est-ce que codecks-cli MCP ?
codecks-cli est un serveur MCP. Permet à un agent IA de gérer les tableaux de projet Codecks.io en créant des cartes, en animant des standups et en structurant les tâches de développement de jeux.
Résumé généré à partir du README du projet
À propos du MCP server codecks-cli
La gestion des tableaux de tâches de développement de jeux est ce que codecks-cli permet aux agents IA et aux développeurs utilisant Codecks.io. Cet outil sert de passerelle pour la gestion de projet, permettant à un agent de prendre en charge les tâches administratives telles que l'animation de standups, le triage de sprint et la structuration de cartes de fonctionnalités. Il est conçu pour aider les studios de jeux à organiser le travail en decks et en cartes sans surcharge manuelle.
Les utilisateurs peuvent installer le serveur localement via une installation Python et un jeton API Codecks officiel avec des accès en lecture et en écriture. Le système prend en charge diverses interfaces, notamment une CLI autonome, une API Python et un MCP server. Alors que la CLI est optimisée pour un contexte léger et une sortie JSON, l'implémentation MCP offre des fonctionnalités avancées comme la mise en cache de snapshots, la coordination d'équipe via des actions de réclamation ou de délégation, et des intégrations d'éditeurs enrichies pour des outils comme Claude Code, Cursor et Windsurf.
Ce que vous pouvez faire avec
- 1Standups quotidiens automatisésDemandez à votre agent de générer un snapshot de l'état d'avancement actuel, incluant les tâches terminées, en cours ou bloquées.
- 2Structuration de fonctionnalités de jeu complexesDemandez à l'agent de créer une carte Hero qui génère automatiquement les sous-cartes associées pour le code, le design, l'art et l'audio.
- 3Synchronisation des documents de conceptionDonnez instruction à l'IA d'analyser un Game Design Document et de créer les tâches correspondantes dans votre tableau de projet.
- 4Coordination de workflows multi-agentsUtilisez le MCP server pour permettre à différents agents de se réclamer, de libérer ou de déléguer des tâches les uns aux autres.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Configuration
CODECKS_ATTACH_ALLOW_DIRS
| Nom | Description | Type |
|---|---|---|
| CODECKS_ATTACH_ALLOW_DIRS | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblerangogamedev/codecks-cli is public and reachablegithub.com/rangogamedev/codecks-cli ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-11github.com/rangogamedev/codecks-cli ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubcodecks-cli
Native Journey tools are available experimentally. See the MCP reference for their internal-API limitations and validation status.
Game developers should be making games, not managing task boards.
codecks-cli gives your AI agent project management tools for Codecks.io — standups, feature scaffolding, sprint health, batch operations, and multi-agent coordination. Your agent handles the admin. You focus on the game.
Also works as a standalone CLI and Python API. Zero runtime dependencies.
What is Codecks?
Codecks is a card-based project management tool built for game studios — think Trello meets collectible card games. It organizes work into decks (boards), cards (tasks), and supports effort estimation, milestones, and team workflows. Codecks has an official API (since v2.96) but no CLI — codecks-cli fills that gap.
Agent Quick Start
pip install git+https://github.com/rangogamedev/codecks-cli.git
codecks-cli setup # walks you through tokens — no DevTools needed
codecks-cli agent-init --agent # verify: returns account + project context
Upgrading from 0.5 (Codecks v2.96)
Codecks now has official API tokens, and the old browser-cookie token has stopped working reliably (it is officially retired on 2026-12-31). Upgrading takes two minutes:
- In Codecks, open Your Profile → API Tokens, create a token with read & write access, and copy it (it is shown once; it starts with
cdxut_). - Run
codecks-cli setup, paste the token, and pick the deck new cards should go to. - Delete
CODECKS_REPORT_TOKENandCODECKS_ACCESS_KEYfrom your.env; they are no longer used.
Full migration guide — breaking changes, token best practices, troubleshooting: docs/migration-0.6.md. Summary: 0.6.0 changelog.
Your agent can now use codecks-cli <command> --agent via Bash. No special prompt needed — the CLI outputs stable JSON.
Want a plug-and-play PM skill? Copy examples/skills/pm/SKILL.md to .claude/commands/pm.md and use /pm.
Want MCP tools too? pip install "codecks-cli[mcp] @ git+https://github.com/rangogamedev/codecks-cli.git" — see docs/ai-agent-guide.md.
What Your Agent Can Do
- Run standups and sprint triage
- Create, update, archive, and batch-close cards
- Scaffold Hero cards with Code/Design/Art/Audio sub-cards
- Batch operations via
--ids-only | --stdinpipes (~40 bytes/card) - Sync tasks from a Game Design Document
- Coordinate multiple agents via MCP (claim/release/delegate)
Why CLI-First
The CLI is the recommended default for AI agents:
- 25x leaner context than loading 53 MCP tool schemas
- JSON output with
--agentflag - Pipe-friendly batch workflows (
--ids-only,--stdin,@last) - No MCP dependency needed for routine PM work
MCP adds caching, team coordination, and richer editor integrations when you need them.
Human Quick Start
codecks-cli cards --format table
codecks-cli standup --format table
codecks-cli create "Fix login bug" --deck Backlog
codecks-cli attach <uuid> mockup.png
See docs/cli-reference.md for the full command reference.
Attachments
attach (and create --file, and the attach_files MCP tool) only uploads files that resolve inside an allowed root. Allowed by default: the project root and the current working directory, plus any directory listed in CODECKS_ATTACH_ALLOW_DIRS (os.pathsep-separated — : on Unix, ; on Windows). Entries that are not absolute paths, are not existing directories, or name a whole filesystem root are ignored with a warning.
CODECKS_ATTACH_ALLOW_DIRS=/srv/art:/mnt/renders codecks-cli attach <uuid> /srv/art/hero.png
codecks-cli attach <uuid> hero.png --dry-run # resolved path + size + SHA-256, no upload
Dot-prefixed path components, credential-looking names (*.pem, *.key, id_rsa*, *token*, *secret*), and anything under /etc, /proc, or /sys are always refused. The MCP tool takes the same dry_run flag. Full rules: docs/cli-reference.md.
How It Works
CLI (codecks-cli) ─┐
Python API ─┤── CodecksClient ── Codecks HTTP API
MCP Server ─┘ (40 methods)
All three interfaces wrap the same CodecksClient library. The CLI formats output for terminals, the API returns dicts, and the MCP server adds caching, guardrails, and team coordination.
Features
- Card management — create, update, attach files, archive, delete with filtering by status, priority, deck, owner, milestone, tags, and text search
- Feature scaffolding — Hero cards with linked Code/Design/Art/Audio sub-cards
- Daily standups — done, in-progress, blocked, and in-hand snapshot
- Sprint health — blocked, stale, unassigned, and suggested next cards
- Batch operations — pipe workflows and MCP batch tools (up to 20 cards/call)
- Team coordination — claim/release/delegate across multiple agents (MCP)
- GDD sync — parse a Game Design Document and sync tasks to Codecks
- Snapshot caching — MCP reads in <50ms with selective invalidation
- 1000+ tests — full offline test suite, no live API calls
Setup
Run codecks-cli setup — it walks you through everything interactively. No manual token hunting required.
If you prefer manual setup, see .env.example for the configuration format and docs/ai-agent-guide.md for details on each token.
Documentation
| Document | Contents |
|---|---|
| docs/ai-agent-guide.md | Full AI agent setup, CLI reference, MCP setup, customization |
| docs/migration-0.6.md | Upgrading from 0.5.x: breaking changes, API token best practices, troubleshooting |
| docs/cli-reference.md | CLI command reference and Python API |
| docs/mcp-reference.md | MCP tool inventory, caching, error contract, team coordination |
| examples/ | Setup wizard, PM skill, game-dev agent example |
| AGENTS.md | AI agent instructions (tokens, API pitfalls, known bugs) |
| DEVELOPMENT.md | Architecture, dev setup, testing, release process |
| CONTRIBUTING.md | How to contribute |
| CHANGELOG.md | Version history |
Community
Questions? Ideas? Share your agent setup? Visit Discussions.
Contributing
Contributions welcome! See CONTRIBUTING.md.
License
MIT — see LICENSE.
Questions sur codecks-cli MCP
Comment configurer codecks-cli pour mon agent ?
Lancez la commande de configuration interactive qui vous guidera à travers le processus de jeton. Vous pouvez ensuite initialiser le contexte de votre agent à l'aide de la commande agent-init.
Que peut faire un agent IA avec cet outil ?
Les agents peuvent animer des standups, effectuer le triage de sprint, gérer les cartes (création, mise à jour, archivage), structurer des cartes de fonctionnalités avec des sous-cartes et coordonner les tâches entre plusieurs agents.
Comment l'utiliser avec MCP ?
Vous pouvez installer la version MCP spécifiquement via pip en utilisant l'extension [mcp].