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.zipGet 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 violationsGet a path to dottestcli — returns a path to
dottestcliinside the same installation directory as the MCP server. This can be customized by setting thedottest.cli.pathproperty in themcp/etc/dottestmcp.propertiesfile.
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.
...