Installing ClearCase® MCP server

This topic describes how to install MCP server on 64-bit Linux and Windows platforms.

Before you begin

Before installing ClearCase MCP server, ensure that the following requirements are met:
  • Python version 3.11 or later is installed on the host and your path.
  • Either the full ClearCase 11.0.0.06 server or client (which, include the cleartool command-line) is installed on the host.

About this task

The installation process involves a setup script that creates a virtual environment, unzips the server artifacts, and installs dependencies, such as pip, uv, mcp, and pydantic.

Install MCP server on linux_x86_64:

When you install ClearCase 11.0.0.06 on linux_x86_64, you will find the MCP artifacts at:
  • /opt/devops/code/clearcase/linux_x86_64/etc/extensions/cc-mcp.zip
  • /opt/devops/code/clearcasee/linux_x86_64/etc/extensions/setup_cc_mcp_servers.py

To install the MCP server, run the following command:

python setup_cc_mcp_servers.py -v dir-for-server-virtual-env -z path-to-zip-file

For example:

python setup_cc_mcp_servers.py -v /var/tmp/ccmcp/mytestvenv -z /var/tmp/ccmcp/cc-mcp.zip

Install MCP server on win_x86_64:

When you install ClearCase 11.0.0.06 on win_x86_64, you will find the MCP artifacts at:
  • c:\Program Files\DevOps\Code\ClearCase®\etc\extensions\cc-mcp.zip
  • c:\Program Files\DevOps\Code\ClearCase®\etc\extensions\setup_cc_mcp_servers.py

To install the MCP server, run the following command:

python setup_cc_mcp_servers.py -v dir-for-server-virtual-env -z path-to-zip-file

For example:

py setup_cc_mcp_servers.py -v c:\ccmcp\mytestvenv -z c:\ccmcp\cc-mcp.zip
If you have installed ClearCase in a non-default location, follow these steps:
Note: This is applicable to both Linux and Windows platforms.
  1. Create a file named config.ini in the directory where you installed the ClearCase MCP server. The contents of the file should be: 
    [ClearCase]
 path=path-to-dir-containing-cleartool
  2. Alternatively, if you are using the MCP server in Visual Studio Code (VS Code), you can also refer to the VS Code documentation to add the CLEARCASE_HOME environment variable to the mcp.json file. The value of CLEARCASE_HOME should be the path to the directory containing cleartool.

Results

After completing this task:
  • The ClearCase MCP server is installed and operational.
  • You can use the MCP server to perform select number of cleartool operations.