sanyambassi/ciphertrust-manager-mcp-server

This project implements an independently-developed CipherTrust MCP (Model Context Protocol) server that allows AI Assistants like Claude or Cursor to interact with CipherTrust Manager resources using the ksctl CLI.
Table of Contents
- Important Notice
- Features
- Prerequisites
- Installation
- Configuration
- Usage
- Testing
- Integration with AI Assistants
- Environment Variables
- Troubleshooting
- Project Structure
- Contributing
- Legal
- License
Important Notice
This is an **independent, open-source project**. Please note:
- ⚠️ **Not officially supported** by Thales
- ✅ **Uses public APIs** and documented interfaces
- 🔧 **Independently maintained**
- 📝 **Use at your own risk** - test thoroughly in your environment
- 💼 **No warranty** - see license for full terms
For official CipherTrust Manager support, please contact Thales directly.
Features
The MCP server exposes a set of tools and endpoints for clients (such as Claude Desktop and Cursor) to interact with CipherTrust resources. Supported operations include:
- Key management
- CTE client management
- User management
- Connection management
- And more
**Benefits:**
- Unified interface for AI assistants to interact with CipherTrust Manager
- Support for key management, connection management, CTE client management, and more
- JSON-RPC communication over stdin/stdout
- Configurable via environment variables
Prerequisites
- **Git**
- **Python 3.11 or higher**
- **uv** for dependency management
- **Access to a CipherTrust Manager instance**
- **Valid CipherTrust Manager credentials**
Installing Git (Windows)
If you don't have Git installed on Windows, follow these steps:
- **Download and install Git for Windows**: https://git-scm.com/download/win
- **Or install via winget**:
- **Verify installation** - Open PowerShell and execute:
You should see the installed Git version.
Installing Python and uv
Method 1: Manual Installation
1. Download Python
2. Run the Installer
3. Verify Installation
Open a new terminal and run:
4. Install uv
5. Clone the Repository
6. Create a Virtual Environment and Install Dependencies
Method 2: Using winget (Windows)
1. Install Python with winget
2. Close and Reopen PowerShell
This ensures Python is available in your PATH.
3. Verify Installation
4. Install uv
5. Clone the Repository
6. Create a Virtual Environment and Install Dependencies
Configuration
(Optional) Copy and Edit the Example Environment File
**Example .env:**
You can also set these as environment variables directly instead of using a .env file.
**Example .env content:**
Usage
**⚠️ Important:** Before starting, either the environment variable or .env should contain a valid CipherTrust Manager URL.
You have two main ways to run the CipherTrust MCP Server:
Method 1: Direct Execution
This runs the main() function in ciphertrust_mcp_server/__main__.py.
Method 2: Module Execution
Testing
This project includes comprehensive testing capabilities using the Model Context Protocol Inspector and Python unit tests.
Quick Testing
Available Testing Methods
- **🔧 Manual JSON-RPC Testing**: Direct stdin/stdout communication for debugging and development
- **🖥️ Interactive UI Testing**: Visual web interface for manual testing and debugging
- **⚡ CLI Automated Testing**: Command-line automation for CI/CD integration
- **🧪 Python Unit Tests**: Comprehensive unit testing for server components