# Mantis MCP Serveur MCP Python pour connecter un agent à MantisBT via l'API REST. Conforme aux spécifications Intersel (outils de mutation + ressources de lecture). ## Prérequis - Python 3.10+ - [uv](https://docs.astral.sh/uv/) recommandé - Token API MantisBT (Paramètres utilisateur → Jetons API) ## Installation ```bash uv sync ``` ## Configuration Copiez `.env.example` vers `.env` : ```env BASE_URL=https://your-mantis-server.com/mantis API_KEY=your_api_token_here ``` Les anciennes variables `MANTIS_BASE_URL` / `MANTIS_API_TOKEN` restent supportées. ## Lancement ```bash uv run mantis-mcp ``` ## Configuration Cursor Fichier `.cursor/mcp.json` : ```json { "mcpServers": { "mantis": { "command": "uv", "args": ["run", "mantis-mcp"] } } } ``` ## Architecture | Module | Rôle | |--------|------| | `config/initialization.py` | Chargement `.env`, validation, démarrage MCP | | `services/rest_client.py` | Client REST synchrone (`ClientREST.execute`) | | `mcp/tools.py` | Outils de mutation | | `mcp/resources.py` | Ressources de lecture | | `mcp/filters.py` | Whitelist/blacklist pour optimiser le contexte | ## Outils (tools/call) | Outil | Méthode REST | Description | |-------|--------------|-------------| | `create_issue` | POST `/api/rest/issues` | Crée un ticket | | `modify_issue` | PATCH `/api/rest/issues/{id}` | Modifie un ticket | | `add_issue_note` | POST `/api/rest/issues/{id}/notes` | Ajoute un commentaire | ## Ressources (resources/read) | URI | Endpoint REST | |-----|---------------| | `mantisbt://issues` | GET `/api/rest/issues` | | `mantisbt://issues/assigned` | GET `/api/rest/issues?filter_id=assigned` | | `mantisbt://issues/{id}` | GET `/api/rest/issues/{id}` (sans history/notes) | | `mantisbt://issues/{id}/notes` | GET avec `select=notes` | | `mantisbt://issues/{id}/history` | GET avec `select=history` | | `mantisbt://projects` | GET `/api/rest/projects` | | `mantisbt://projects/{id}` | GET `/api/rest/projects/{id}` | | `mantisbt://projects/{id}/handlers` | GET `/api/rest/projects/{id}/handlers` |