Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This section describes how to integrate the dotTESTdotTEST's MCP (Model Context Protocol) server with AI coding agents, such as GitHub Copilot and Codex CLI.

...

The MCP server is located at <INSTALL_DIR>/integration/mcp/.

Prerequisites:

  • dotTEST is installed.

  • Java is available (the launcher uses  uses dotTEST's bundled JRE automatically).

...

  • Search dotTEST documentation — queries dotTEST feature docs bundled in dottest-ai-docs.zip

  • Get static analysis rule documentation — retrieves detailed documentation for

...

  • specific dotTEST rules

...

  • Get relevant rules — finds rules related to a given topic or keyword

  • Get violations from a report — parses and filters

...

dotTEST

...

  • a dotTEST XML report (report.xml) to retrieve violations

  • Get a path to dottestcli — returns a path to dottestcli inside the same installation directory as the MCP server. This can be customized by setting the dottest.cli.path property in the mcp/etc/dottestmcp.properties file.

The server uses the current working directory as the workspace root and stores its local cache in .dottest/dottestmcp/ within that directory.

...

The MCP server reads its settings from <INSTALL_DIR>/integration/mcp/etc/dottestmcp.properties. The default configuration is: 

Code Block
documentation.path=${dottestmcp:root_dir}/dottest-ai-docs.zip
rule.documentation.path=${dottestmcp:root_dir}/dottest-ai-rules.zip
rule.doc.html.location=${dottestmcp:root_dir}/../../rules/doc.zip
product.name=dotTEST

These paths are resolved relative to the MCP server root directory and generally do not need to be changed.

...

However adding the dottest.cli.path property can change the behavior of the get_dottestcli_path tool in case customization is needed.

Local Storage

The MCP server stores its runtime cache in the following location:

  • Default:  <workspace>/.dottest/dottestmcp/
  • Fallback (if write access is unavailable):  %TEMP%\dottest\dottestmcp\

The workspace directory is automatically set to the current working directory from which the coding agent launches the MCP server process.

...