centreon-mcp

# Centreon MCP Server This project offers an MCP server for Centreon. Built in Python with the [FastMCP](https://gofastmcp.com/getting-started/welcome) library, it enables users to perform operations on a Centreon instance using natural language commands. ## Features Using natural language, you can ask the Centreon MCP server to: ### Keep an eye on your infrastructure - Check the real-time status of your hosts and services, filtering by state, group, category, poller, and more. - Get an instant count of how many resources are up, down, or in trouble, without digging through dashboards. - Look back at what happened on a host or service recently — outages, notifications, downtimes, acknowledgements, and comments. ### Manage your monitoring configuration - Browse, create, update, and delete hosts, services, and their categories, groups, severities, and templates. - Manage commands and monitoring servers (pollers). - Push configuration changes to your pollers by generating or reloading them on demand. ### React to incidents - Acknowledge an alert, schedule a downtime, add a comment, or trigger an immediate check. - Review current acknowledgements and downtimes, and cancel them when they're no longer needed. ### Analyze performance - Retrieve a service's metrics along with their current values and warning/critical thresholds. > For the exact list of underlying tools, see [TOOLS.md](TOOLS.md). ## Quick Start 1. Clone the repository ```shell git clone https://github.com/centreon/centreon-mcp.git cd centreon-mcp ``` 2. Ensure all required environment variables are set. Default values are used for optional variables. | Name | Required | Default | Description | | ------------------------ | -------- | ------- | ----------------------------------------------------- | | `CENTREON_BASE_URL` | `True` | | Base URL of the Centreon instance. | | `CENTREON_MCP_PORT` | `False` | `8000` | Port used to start the Centreon MCP service. | | `CENTREON_MCP_LOG_LEVEL` | `False` | `INFO` | Minimal severity level for Centreon MCP service logs. | ### Using UV 3. Start the MCP server ```shell uv run centreon-mcp-server ``` 4. If the MCP server is not reachable from the internet, expose it using a tunneling tool such as [Ngrok](https://ngrok.com): ```shell ngrok http 8000 ``` > Replace `8000` with the value of `CENTREON_MCP_PORT` if you changed the default. ### Using Docker 3. Build Docker image ```shell docker build -t centreon/mcp . ``` 4. Start the MCP server ```shell docker compose up ``` 5. To make it reachable from the internet, export `NGROK_AUTHTOKEN` in the environment and enable `ngrok` profile. ```shell docker compose --profile ngrok up ``` > Use `curl http://localhost:4040/api/tunnels` to retrieve public URL ## Integration <details> <summary>ChatGPT</summary> 1. Open [ChatGPT](https://chatgpt.com) and sign in. 2. Click on your profile picture in the bottom-left corner, then select **Settings**. 3. Go to the **Connectors** section and click **Create**. 4. Fill in the form: - **Name**: `Centreon` (or any name you prefer) - **URL**: the address of your running MCP server, e.g. `https://<ngrok-subdomain>.ngrok-free.app/mcp` - **Headers**: Add valid Centreon API token in headers under field `centreon-api-token` 5. Click **Save** to register the connector. Once the connector is added, ChatGPT will automatically discover and use the Centreon MCP tools in your conversations. </details> <details> <summary>Mistral Le Chat</summary> 1. Open [Le Chat](https://chat.mistral.ai) and sign in. 2. Click on **Intelligence** in the left sidebar, then select **Connectors**. 3. Click **Add a connector**, then choose **Custom MCP connector**. 4. Fill in the form: - **Name**: `Centreon` (or any name you prefer) - **URL**: the address of your running MCP server, e.g. `https://<ngrok-subdomain>.ngrok-free.app/mcp` - **Headers**: Add valid Centreon API token in headers under field `centreon-api-token` 5. Click **Save** to register the connector. Once the connector is added, Le Chat will automatically discover and use the Centreon MCP tools in your conversations. </details> <details> <summary>Claude Code</summary> Register your MCP server using the HTTP transport with the local address and Centreon API token in headers ```shell claude mcp add -t http centreon http://localhost:8000/mcp -H "centreon-api-token: <token>" ``` > Replace `8000` with the value of `CENTREON_MCP_PORT` if you changed the default. List configured MCP servers and confirm `centreon` is present: ```shell /mcp list ``` </details>