Skip to main content
Glama
thales-cdsp-csm-mcp-server

thales-cdsp-csm-mcp-server

by sanyambassi

Thales CSM MCP Server

Simple MCP server for Thales CipherTrust Secrets Management, powered by Akeyless.

🎬 Demo Videos

📹 Part I: Usage & Functionality - Watch on YouTube

This video demonstrates:

  • Setting up Cursor AI integration

  • Creating and managing secrets and DFC Keys through AI chat

  • Security compliance workflows

  • Example prompts and functionality

📹 Part II: Deployment & Installation - Watch on YouTube

This video covers:

  • Step-by-step installation process

  • Configuration and setup

  • Deployment options

Related MCP server: @1claw/mcp

🎯 Key Features

Intelligent App Development & Security Migration

The server includes a powerful prompt that automatically determines whether you want to:

  • Create a NEW app with built-in CipherTrust integration

  • Secure an EXISTING app by migrating hardcoded secrets to CipherTrust

For New Apps:

  • Generates complete Python implementations with CipherTrust integration

  • Uses the get_api_reference tool for native API integration

  • Provides production-ready code with proper error handling

For Existing Apps:

  • Scans codebase for hardcoded secrets using intelligent detection

  • Categorizes secrets by type (key-value pairs vs standalone)

  • Uses manage_secrets MCP tool to create CipherTrust secrets

  • Generates migration reports and updated code

  • Provides testing and validation instructions

Secret Type Classification:

  • Key-Value Pairs/JSON format: AWS credentials, database configs, OAuth tokens

  • Standalone Secrets (Text format): Single passwords, individual tokens, certificates

📋 Prerequisites

Before you begin, ensure you have the following installed on your system:

  • Python 3.8+: Required for running the MCP server

  • uv: Modern Python package manager (recommended) or pip

  • git: For cloning the repository

  • dotenv: Environment variable management

  • fastmcp: MCP server framework

  • Thales CipherTrust Manager access

  • Valid Akeyless credentials

Installing Prerequisites

Python

# Check if Python is installed
python --version
# or
python3 --version

# Install Python (Ubuntu/Debian)
sudo apt update && sudo apt install python3 python3-pip

# Install Python (macOS)
brew install python

# Install Python (Windows)
# Download from https://python.org
# Install uv
pip install uv

# Verify installation
uv --version

git

# Check if git is installed
git --version

# Install git (Ubuntu/Debian)
sudo apt update && sudo apt install git

# Install git (macOS)
brew install git

# Install git (Windows)
# Download from https://git-scm.com

dotenv

# Check if python-dotenv is installed
python -c "import dotenv; print('dotenv available')"

# Install python-dotenv
pip install python-dotenv

# Verify installation
python -c "import dotenv; print(f'dotenv version: {dotenv.__version__}')"

fastmcp

# Check if fastmcp is installed
python -c "import fastmcp; print('fastmcp available')"

# Install fastmcp
pip install fastmcp

# Verify installation
python -c "import fastmcp; print(f'fastmcp version: {fastmcp.__version__}')"

🚀 What this MCP server features

  • Secrets Management: Create, read, update, delete secrets

  • DFC Key Management: DFC encryption keys (AES, RSA)

  • Account Management: Get Akeyless account details

  • Analytics: Fetch analytics data

  • Authentication Methods: Manage Authentication Methods

  • App Development & Security: Intelligent app creation and secret migration

  • Roles: Manage Roles

  • Targets: Manage Targets

  • Security: Guidelines and best practices

  • MCP Protocol: Model Context Protocol compliance

⚡ Quick Start

1. Install

Option A: Using pip (Traditional)

git clone https://github.com/sanyambassi/thales-cdsp-csm-mcp-server
cd thales-cdsp-csm-mcp-server
pip install -r requirements.txt
# Install uv if you don't have it
pip install uv

# Clone and setup
git clone https://github.com/sanyambassi/thales-cdsp-csm-mcp-server
cd thales-cdsp-csm-mcp-server

# Install dependencies (creates .venv automatically)
uv sync

2. Configure

Create .env file:

AKEYLESS_ACCESS_ID=your_access_id
AKEYLESS_ACCESS_KEY=your_access_key
AKEYLESS_API_URL=https://your-ciphertrust-manager/akeyless-api/v2
LOG_LEVEL=INFO
AKEYLESS_VERIFY_SSL=false

3. Run

Using pip (Traditional)

# stdio mode
python main.py

# HTTP mode 
python main.py --transport streamable-http --host localhost --port 8000
# stdio mode
uv run python main.py

# HTTP mode 
uv run python main.py --transport streamable-http --host localhost --port 8000

🛠️ Available Tools

Tool

Description

manage_secrets

Create static secrets, get static secret values, update, delete secrets (static, dynamic, rotated) with type filtering and dynamic secret creation

manage_dfc_keys

Manage encryption keys

manage_auth_methods

Authentication and access control

manage_rotation

Secret rotation policies

manage_customer_fragments

Enhanced security features

security_guidelines

Security best practices

manage_roles

List and get role information

manage_targets

List, get, and create targets

manage_analytics

Get analytics and monitoring data

manage_account

Get account settings and licensing

get_api_reference

Get API reference for native Akeyless integrations (generic workflows + S3 example)

🔍 Test It

# Run tests
python tests/run_tests.py
python.exe tests\test_mcp_protocol.py

# Test health endpoint (HTTP mode)
curl http://localhost:8000/health

📚 Documentation

🎯 Use Cases

  • AI Assistants: Claude Desktop, Cursor AI

  • Web Applications: REST API integration

  • Automation: CI/CD, scripts, tools

  • Enterprise: Secrets management, compliance

🤖 AI Assistant Integration

Claude Desktop

{
  "mcpServers": {
    "thales-csm": {
      "command": "python",
      "args": ["main.py", "--transport", "stdio"],
      "env": {
        "AKEYLESS_ACCESS_ID": "your_access_id_here",
        "AKEYLESS_ACCESS_KEY": "your_access_key_here",
        "AKEYLESS_API_URL": "https://your-ciphertrust-manager/akeyless-api/v2",
        "LOG_LEVEL": "INFO"
      }
    }
  }
}

Cursor AI

{
  "mcpServers": {
    "thales-csm": {
      "command": "python",
      "args": ["main.py", "--transport", "stdio"],
      "env": {
        "AKEYLESS_ACCESS_ID": "your_access_id_here",
        "AKEYLESS_ACCESS_KEY": "your_access_key_here",
        "AKEYLESS_API_URL": "https://your-ciphertrust-manager/akeyless-api/v2",
        "LOG_LEVEL": "INFO"
      }
    }
  }
}

Configuration Parameters

  • env: Environment variables for Akeyless authentication and logging

  • command: Python executable to run the server

  • args: Command line arguments for the server

⚠️ Important Notes

  • Full Path Required: args must include the full absolute path to main.py

  • Windows Paths: Use double backslashes \\ in Windows paths (e.g., C:\\thales-cdsp-csm-mcp-server\\main.py)

  • Unix Paths: Use forward slashes / in Unix/Linux paths (e.g., /home/user/thales-cdsp-csm-mcp-server/main.py)

Configuration Templates

🤝 Support

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Available Tools

12 tools
get_api_referenceA

API REFERENCE TOOL - Generate production-ready code examples and integration patterns

SUPPORTED ENDPOINTS: • workflow: Complete integration patterns and best practices • auth: Authentication flows and token management • create-secret: Secret creation and management APIs • get-secret-value: Secret retrieval and access patterns • list-items: Item listing and discovery APIs • delete-item: Item deletion and cleanup operations • list-roles: Role management and access control • list-targets: Target management and configuration

INTEGRATION FEATURES: • Production-ready code examples with authentication • Complete error handling and retry logic • Best practices for secure integration patterns • Multi-language support (Python, JavaScript, etc.) • Token management and session handling

USE CASES: • Building custom applications and integrations • CI/CD pipeline integration and automation • Microservice authentication and configuration • Native client development and SDK creation • Production system integration and deployment

Example: Generate complete Python client code for secret management

Inputs: api_endpoint (required), language, include_auth, include_error_handling. Returns: object

manage_accountA

ACCOUNT ADMINISTRATION TOOL - Manage organizational settings and governance

SUPPORTED ACTIONS: • get: Retrieve complete account configuration, licensing details, and system-wide policies

ACCOUNT INFORMATION PROVIDED: • Organizational details and company profile • Licensing and subscription tier information • Service tier, SLA level, and feature availability • Usage quotas, capacity limits, and billing details • System configuration and security policies • Governance, compliance, and audit settings • Multi-tenant configuration and access controls

USE CASES: • Account setup and initial configuration • Compliance and audit preparation • License management and planning • Security policy review and updates • Service tier evaluation and upgrades • Multi-tenant administration

Example: Review account licensing and compliance configuration

Inputs: action (required), json, uid_token. Returns: object

manage_analyticsA

ANALYTICS & MONITORING TOOL - Comprehensive infrastructure monitoring and reporting

SUPPORTED ACTIONS: • get: Retrieve comprehensive monitoring data, usage statistics, and performance metrics

ANALYTICS COVERAGE: • Usage statistics and item counts by type (Secrets, Targets, Roles, Keys) • Geographic distribution of access requests and client patterns • Security risk analysis and certificate expiry tracking • Authentication method usage and access control compliance • Multi-region usage distribution and product-specific metrics • Resource utilization, capacity planning, and audit summaries

FILTERING OPTIONS: • Filter by item type (Targets, Static Secrets, Dynamic Secrets, DFC Keys, etc.) • Filter by risk level (Expired, Healthy, Expiring Soon certificates) • Filter by product component (Secrets Management, Advanced Data Protection, etc.)

USE CASES: • Security operations center (SOC) dashboards • Compliance reporting and audit preparation • Capacity planning and resource optimization • Risk assessment and vulnerability management • Executive reporting and KPI tracking

Example: Get security risk analysis for certificate expiry management

Inputs: action (required), json, uid_token, filter_by_risk, +2 more. Returns: object

manage_auth_methodsA

AUTHENTICATION METHODS MANAGEMENT TOOL - Create, manage, and secure authentication methods

SUPPORTED ACTIONS: • create_api_key: Create API key authentication methods with IP restrictions and expiration • create_email: Create email-based authentication methods with MFA support • list: List all authentication methods with filtering and pagination • get: Retrieve detailed authentication method configuration and status • update: Modify authentication method properties, credentials, and settings • delete: Delete individual authentication methods with proper cleanup • delete_auth_methods: Bulk delete authentication methods within a specific path

SECURITY FEATURES: • IP address restrictions and CIDR whitelisting • Access expiration and JWT TTL management • Multi-factor authentication (MFA) support • Audit logging and compliance tracking • Delete protection and access control

Example: Create a secure API key for application authentication

Inputs: action (required), json, name, path, +19 more. Returns: object

manage_customer_fragmentsA

CUSTOMER FRAGMENT MANAGEMENT TOOL - Manage customer fragment encryption and security

SUPPORTED ACTIONS: • list: List customer fragments with path filtering and pattern matching • export: Export customer fragments with optional JSON format • download: Download customer fragments (alias for export action)

SECURITY FEATURES: • Customer fragment encryption for enhanced security • Access control and audit trails • Enterprise-grade fragment management • Compliance and security reporting

USE CASES: • Customer fragment inventory and management • Security compliance and audit preparation • Fragment backup and export operations • Enhanced encryption key management

Example: List and export customer fragments for security audit

Inputs: action (required), json, path, filter_by. Returns: object

manage_dfc_keysA

DFC KEY MANAGEMENT TOOL - Advanced encryption key management and lifecycle

SUPPORTED ACTIONS: • create: Create new DFC keys with encryption algorithms (AES128GCM, AES256GCM, RSA2048, etc.) • update: Modify DFC key properties, tags, and metadata • delete: Delete DFC keys with proper cleanup • list: List DFC keys in directory with filtering • set_state: Enable/disable DFC keys for access control • rotate: Rotate DFC keys on demand with new certificates and key data

ADVANCED FEATURES: • Auto-rotation with configurable intervals (7-365 days) • Customer fragment encryption for enhanced security • Self-signed certificate generation with X.509 support • Split levels (3 or 4 fragments) for key distribution • Expiration and rotation event notifications • Comprehensive metadata and configuration support

SECURITY CAPABILITIES: • Enterprise-grade key management with audit trails • Access control and delete protection • Customer fragment integration • Certificate lifecycle management • Compliance and governance reporting

Example: Create an AES256GCM DFC key with auto-rotation for application encryption

Inputs: action (required), json, name, path, +33 more. Returns: object

manage_gatewaysB

GATEWAY MANAGEMENT TOOL - Monitor and manage gateway infrastructure

SUPPORTED ACTIONS: • list: List available gateways with detailed information and filtering

GATEWAY INFORMATION PROVIDED: • Gateway configuration and status • Connection details and endpoints • Performance metrics and health status • Access control and security settings • Integration and routing information

USE CASES: • Gateway infrastructure monitoring • Connection troubleshooting and diagnostics • Performance analysis and optimization • Security configuration review • Gateway inventory and management

Example: List all gateways to monitor infrastructure health

Inputs: action (required), json, path, filter_by. Returns: object

manage_rolesA

ROLE MANAGEMENT TOOL - Discover and analyze role-based access control

SUPPORTED ACTIONS: • list: Discover all roles with advanced filtering and pagination • get: Retrieve comprehensive role details including permissions, access rules, and policies

ROLE INFORMATION PROVIDED: • Permission sets and access rules • Associated policies and restrictions • User/group assignments and mappings • Resource access configurations • Audit and compliance information

USE CASES: • Security audits and compliance reporting • Access permission troubleshooting • Role-based access control planning • Identity and access management (IAM) integration • Permission inheritance analysis

Example: Check what permissions the 'database-admin' role has

Inputs: action (required), json, name, filter, +2 more. Returns: object

manage_rotation_settingsC

ROTATION SETTINGS MANAGEMENT TOOL - Automate secret and key rotation for security compliance

SUPPORTED ACTIONS: • set_rotation: Set rotation settings for secrets and keys with scheduling • update_settings: Update existing rotation configurations and parameters • list_rotation: List items with rotation settings and status • get_rotation_status: Get detailed rotation status and history information

ROTATION FEATURES: • Auto-rotation with configurable intervals (7-365 days) • Rotation event notifications and scheduling • Advanced rotation windows and cron-based scheduling • Rotate after disconnect settings for security • Comprehensive rotation status tracking and reporting

SECURITY BENEFITS: • Automated security through intelligent rotation scheduling • Enterprise-grade rotation with access control and audit trails • Compliance with security policies and regulations • Reduced manual intervention and human error • Proactive security through regular credential updates

Example: Set up automated rotation for database credentials every 30 days

Inputs: action (required), json, path, filter_by, +7 more. Returns: object

manage_secretsB

SECRETS MANAGEMENT TOOL - Create, retrieve, update, and delete secrets

SUPPORTED ACTIONS: • create_static_secret: Create text/JSON secrets with metadata • get_static_secret_value: Retrieve secret values securely
• update: Modify secret properties and values • delete: Delete individual secrets (smart detection) • delete_items: Bulk delete multiple secrets or directories • list: List secrets in directory with type filtering • list_dynamic_secrets: List all dynamic secrets globally • create_dynamic_secret_ldap: Create LDAP dynamic secrets • create_dynamic_secret_mysql: Create MySQL dynamic secrets • create_dynamic_secret_mongodb: Create MongoDB dynamic secrets • list_shared_items: List shared secrets and items

DELETE OPERATIONS: • Individual: delete(name="/secret1") • Multiple: delete_items(items=["/secret1", "/secret2"]) • Directory: delete_items(path="/directory/")

Example: Create a database password secret

Inputs: action (required), ssl, ttl, json, +72 more. Returns: object

manage_targetsB

TARGET MANAGEMENT TOOL - Manage external system connections and integrations

SUPPORTED ACTIONS: • list: Discover all configured targets with filtering • get: Retrieve detailed target configuration and credentials • create: Create new database or LDAP targets • delete: Delete individual target with version control • delete_targets: Bulk delete targets within a specific path

SUPPORTED TARGET TYPES: • Database: MySQL, PostgreSQL, MSSQL, Oracle, Snowflake, MongoDB, Cassandra, HanaDB, Redshift, Redis • LDAP: OpenLDAP, Active Directory • Cloud: AWS, Azure, GCP

Example: Create a MySQL database target for application connections

Inputs: action (required), pwd, ssl, host, +47 more. Returns: object

security_guidelinesA

SECURITY GUIDELINES TOOL - Comprehensive security guidance and compliance management

SUPPORTED ACTIONS: • get_guidelines: Get security best practices and guidelines by category • validate: Validate secrets and configurations for security compliance • audit: Perform comprehensive security audits and assessments • compliance_check: Check compliance with industry standards (SOC2, ISO27001, GDPR, HIPAA)

SECURITY CATEGORIES: • best_practices: Security best practices and recommendations • compliance: Compliance frameworks and requirements • audit: Security audit procedures and checklists • encryption: Encryption standards and key management

COMPLIANCE STANDARDS: • SOC2: Service Organization Control 2 compliance • ISO27001: Information security management systems • GDPR: General Data Protection Regulation • HIPAA: Health Insurance Portability and Accountability Act

SECURITY FEATURES: • Enterprise-grade security with access control and audit trails • Automated security validation and compliance checking • Comprehensive audit procedures and reporting • Industry-standard compliance framework support

Example: Perform security audit and compliance check for SOC2 requirements

Inputs: action (required), json, context, category, +5 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 12 tools

    Disambiguation5/5

    Each tool targets a distinct resource area, from secrets and keys to account, analytics, and security guidelines. Even closely related tools like manage_secrets and manage_dfc_keys are clearly separated by their resource types and actions.

    Naming Consistency4/5

    The naming is largely consistent with a 'manage_<resource>' pattern for 10 of 12 tools, but 'get_api_reference' and 'security_guidelines' deviate. This is a minor inconsistency that does not obscure the tools' purposes.

    Tool Count5/5

    With 12 tools, the server is well-scoped for a secrets and key management platform. Each tool covers a meaningful subdomain without redundancy, fitting comfortably within the ideal 3-15 tool range.

    Completeness4/5

    Core lifecycle operations are covered for secrets, DFC keys, auth methods, and targets, with rotation and security guidelines included. Minor gaps exist: manage_targets lacks an update action, manage_account is read-only, and dynamic secret support covers only LDAP, MySQL, and MongoDB, but these can be worked around.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      MCP server for the Delinea Secret Server and Platform APIs, enabling AI agents to manage secrets, users, groups, folders, roles, and access requests through natural language commands.
      36
      50
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for secure, just-in-time secret retrieval from 1claw vault and malicious content inspection, enabling AI agents to access secrets and security analysis.
      1
      763 npm
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that integrates with ARXsec.io API to execute security scans, compliance checks, secrets management, and remediation actions with policy enforcement, audit logging, and human approval workflows.
      MIT
    • A
      license
      Not graded
      quality
      F
      maintenance
      MCP server for AI-native credential management, enabling agents to securely store, retrieve, and manage API keys with encryption, spending budgets, and audit logging.
      MIT