Centreon MCP ServerBeta
Supervise Centreon from your AI assistant: the MCP server exposes real-time monitoring as tools for any Model Context Protocol client (Claude, IDEs, agents). It reads live status and acknowledges alerts; it does not change your configuration.
What your assistant can do
Real-time status
Query live host and service states, with counters per state.
Alert acknowledgement
Acknowledge a host or service problem with a comment, straight from the assistant.
Rich search filters
Same logical filters as the Centreon API ($and, $or, regex) to target exactly the right resources.
Works with the major AI platforms
MCP is an open standard: any Model Context Protocol compatible client can connect to this server.
Prerequisites
- Python 3.13+ (or Docker)
- A Centreon instance reachable from the MCP server
- A personal API token (Configuration > Users > API tokens)
Deploy the server
git clone https://github.com/CentreonLabs/centreon-mcp.git
cd centreon-mcp
# .env: CENTREON_BASE_URL, CENTREON_API_TOKEN, MCP_API_KEY, NGROK_AUTHTOKEN
docker compose up --build
# -> MCP server on :8000, ngrok tunnel, web UI on :4040git clone https://github.com/CentreonLabs/centreon-mcp.git
cd centreon-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e .
# .env: CENTREON_BASE_URL, CENTREON_API_TOKEN, MCP_API_KEY
fastmcp run centreon_mcp/main.pygit clone https://github.com/CentreonLabs/centreon-mcp.git
cd centreon-mcp
uv sync --all-groups
# .env: CENTREON_BASE_URL, CENTREON_API_TOKEN, MCP_API_KEY
uv run fastmcp run centreon_mcp/main.pyEnvironment variables (.env)
| CENTREON_BASE_URL* | Centreon server URL (without /api/latest) |
| CENTREON_API_TOKEN* | Personal API token (Configuration > Users > API tokens) |
| MCP_API_KEY* | Bearer token clients must send to the MCP server |
| CENTREON_VERIFY_SSL | SSL certificate verification (default: true) |
| CENTREON_CA_BUNDLE | Path to a custom CA bundle (internal PKI) |
| NGROK_AUTHTOKEN | ngrok token (compose.yaml deployment only) |
* required variable
Connect your MCP client
Point your MCP client (Claude Desktop, IDE, agent...) to the server URL with the Authorization header:
{
"mcpServers": {
"centreon": {
"url": "https://your-mcp-host:8000/mcp",
"headers": { "Authorization": "Bearer your-mcp-api-key" }
}
}
}Available tools
- get_realtime_status (live status of a host or service)
- list_all_status (states overview with counters, regex filters)
- acknowledge_resource (acknowledge a problem with a comment)
Beta: tools and interfaces may change without notice. Feedback is welcome on the GitHub repository.