MCP Server for iTop

The MCP server is standalone application providing a MCP interface to iTop.

The set of tools advertised by the MCP server, depends on the webservices available on the iTop instance. The complete list of tools is the following:

In this first version, the MCP server only provides a series of tools (no prompts, no resources).

1. This version only supports token authentication. oAuth authentication is not yet supported.
2. The only protocol supported is streamable HTTPS

1. A web server with PHP 8.2 (with the extensions iconv and ctype) for installing the MCP server.
2. An iTop instance with token authentication enabled, to communicate with, using the REST/JSON webservices
3. The datamodel-production.xml file from your iTop instance (can be a symlink if both iTop and the MCP server are located on the same server)

The MCP server is a standalone PHP/Symfony web application. This means that only the content of the public directory should be accessible via HTTP(S).

The package of the application already contains all the dependencies, so there is no need to run composer when deploying. Just copy the content of the zip file to the web server.

To know more about how to deploy Symfony applications, refer to the Symfony documentation: How to Deploy a Symfony Application.

The configuration parameters are defined in the .env file at the root of the project. The good practice is to create a file .env.local (at the root of the project as well) to overload the default settings. Basically you'll just need:

.env.local

APP_ITOP_URL="https://your-itop.com/"
#APP_ENV="prod"
# Optional, adjust the log level, if needed
#APP_LOG_LEVEL="info"
# Optional, change the prefix for all tools. This can be useful to refer to iTop with a different name (e.g. Helpdesk)
#APP_TOOLS_PREFIX="iTop-"

After you have configured the iTop URL and the datamodel-production.xml file, open your browser and navigate to the MCP server URL. The page that should appear is shown below:

Check that the iTop URL is correct (if not, a red mark ❌️ will be displayed instead of the green check-mark ✅Ok)

Then create a token in iTop (either a personal token or a user token) and configure your AI client as indicated on the page:

mcp-servers.json

"mcpServers": {
    "itop-mcp-server": {
        "type": "streamable-http",
        "url": "https://mcp-server-url",
        "headers": {
           "Authorization": "Bearer =======YOUR-ITOP-TOKEN-HERE====="
        }
    }
}

The tools discovery and data‑model parsing can be slow, so their results are cached on disk with a time‑to‑live of 3600 seconds.

To clear this cache, connect to the server and run the following command from the project’s root directory:

./bin/console cache:clear;./bin/console cache:pool:clear --all