No Description

Khanh Nguyen be3e487ebf init full mantisbt mcp 3 months ago
.cursor be3e487ebf init full mantisbt mcp 3 months ago
mantis_mcp be3e487ebf init full mantisbt mcp 3 months ago
.cursorignore be3e487ebf init full mantisbt mcp 3 months ago
.env.example be3e487ebf init full mantisbt mcp 3 months ago
.gitignore be3e487ebf init full mantisbt mcp 3 months ago
README.md be3e487ebf init full mantisbt mcp 3 months ago
pyproject.toml be3e487ebf init full mantisbt mcp 3 months ago
uv.lock be3e487ebf init full mantisbt mcp 3 months ago

README.md

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 recommandé
  • Token API MantisBT (Paramètres utilisateur → Jetons API)

Installation

uv sync

Configuration

Copiez .env.example vers .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

uv run mantis-mcp

Configuration Cursor

Fichier .cursor/mcp.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