How combodo/itop-mcp works
itop-mcp is a Symfony-based MCP server that exposes iTop operations to an AI agent and communicates with iTop through its REST/JSON webservices. The main workflow is an agent invoking an MCP tool, which prepares a request and delegates to the iTop client; the client authenticates the REST call with the configured token, and the tool formats the response. Separate capabilities cover object reads/search, creation, updates, state stimuli, related-object lookup, and schema discovery. Source excerpts and the SOURCE INDEX support the tool and client links; unsampled Symfony wiring is not assumed.
Main entry points: iTopRestTools.php Request Formatter · DatamodelService.php Datamodel Service · iTopBuilder.php Capability Builder · iTopClient.php REST Client
Components 16
MCP Server
- Capability Builder
src/Capability/iTopBuilder.php - Setup Status Page
src/Controller/HomeController.php
iTop Tools
- Read & Search
src/Tools/core/get/iTopGetTools.php - Create Objects
src/Tools/core/create/iTopCreateTools.php - Update Objects
src/Tools/core/update/iTopUpdateTools.php - Apply Stimulus
src/Tools/core/apply_stimulus/iTopApplyStimulusTools.php - Related Objects
src/Tools/core/get_related/iTopGetRelatedTools.php - Natural Search
src/Tools/core/natural_language_search/iTopNaturalLanguageSearchTool.php - Request Formatter
src/Tools/iTopRestTools.php
Datamodel
- Schema Discovery
src/Tools/schema/iTopSchemaTools.php - Datamodel Service
src/Service/DatamodelService.php
iTop Connection
- iTop Client Interface
src/Service/iTopClientInterface.php - REST Client
src/Service/iTopClient.php - Token User
src/Security/User.php
Other components
- AI Agent
- iTop REST Service
Connections 18
- AI Agent → Capability Builder: uses MCP server
README.md - Capability Builder → Schema Discovery: scans tools
src/Capability/iTopBuilder.php - Read & Search → Request Formatter: formats requests
src/Tools/core/get/iTopGetTools.php - Create Objects → Request Formatter: formats requests
src/Tools/core/create/iTopCreateTools.php - Update Objects → Request Formatter: formats requests
src/Tools/core/update/iTopUpdateTools.php - Apply Stimulus → Request Formatter: formats requests
src/Tools/core/apply_stimulus/iTopApplyStimulusTools.php - Related Objects → Request Formatter: formats requests
src/Tools/core/get_related/iTopGetRelatedTools.php - Natural Search → Request Formatter: formats requests
src/Tools/core/natural_language_search/iTopNaturalLanguageSearchTool.php - Read & Search → Datamodel Service: reads schema
src/Tools/core/get/iTopGetTools.php - Update Objects → Datamodel Service: reads schema
src/Tools/core/update/iTopUpdateTools.php - Apply Stimulus → Datamodel Service: reads schema
src/Tools/core/apply_stimulus/iTopApplyStimulusTools.php - Related Objects → Datamodel Service: reads schema
src/Tools/core/get_related/iTopGetRelatedTools.php - Schema Discovery → Datamodel Service: queries schema
src/Tools/schema/iTopSchemaTools.php - Request Formatter → iTop Client Interface: sends request via
src/Tools/iTopRestTools.php - Capability Builder → iTop Client Interface: checks connection
src/Capability/iTopBuilder.php - REST Client → Token User: gets token from
src/Service/iTopClient.php - REST Client → iTop REST Service: POSTs REST request
src/Service/iTopClient.php - Setup Status Page → REST Client: checks endpoint
src/Controller/HomeController.php