Thales Ciphertrust Manager Mcp Server

CipherTrust Manager MCP サーバー

このプロジェクトは、独自に開発された CipherTrust MCP（Model Context Protocol）サーバーを実装しています。Claude や Cursor などの AI アシスタントが、ksctl CLI を使用して CipherTrust Manager のリソースを操作できます。

目次

• 重要なお知らせ
• 機能
• 前提条件
• インストール
• 設定
• 使用方法
• テスト
• AI アシスタントとの統合
• 環境変数
• トラブルシューティング
• プロジェクト構成
• コントリビュート
• 法的事項
• ライセンス

重要なお知らせ

これは独立したオープンソースプロジェクトです。次の点にご注意ください。

• ⚠️ Thales による公式サポートはありません
• ✅ 公開 API とドキュメント化されたインターフェイスを使用します
• 🔧 独立して保守されています
• 📝 ご自身の責任でご使用ください — ご利用の環境で十分にテストしてください
• 💼 保証はありません — 詳細な条件についてはライセンスをご覧ください

CipherTrust Manager の公式サポートについては、Thales に直接お問い合わせください。

機能

この MCP サーバーは、クライアント（Claude Desktop や Cursor など）が CipherTrust のリソースを操作するためのツールとエンドポイントを提供します。次の操作をサポートしています。

• キー管理
• CTE クライアント管理
• ユーザー管理
• 接続管理
• その他

メリット：

• AI アシスタントが CipherTrust Manager を操作するための統一インターフェイス
• キー管理、接続管理、CTE クライアント管理などをサポート
• stdin/stdout を介した JSON-RPC 通信
• 環境変数による設定

前提条件

• Git
• Python 3.11 以降
• 依存関係管理用の uv
• CipherTrust Manager インスタンスへのアクセス
• 有効な CipherTrust Manager の認証情報

Git のインストール（Windows）

Windows に Git がインストールされていない場合は、次の手順に従ってください。

• Git for Windows をダウンロードしてインストールする：https://git-scm.com/download/win
• または winget でインストールする：

  winget install --id Git.Git -e --source winget
  

• インストールを確認する — PowerShell を開いて次のコマンドを実行します。

  git --version
  

  インストールされた Git のバージョンが表示されます。

Python と uv のインストール

方法 1：手動インストール

1. Python をダウンロードする

# Open PowerShell as Administrator (optional)
cd $env:USERPROFILE\Downloads
Invoke-WebRequest -Uri "https://www.python.org/ftp/python/3.12.4/python-3.12.4-amd64.exe" -OutFile "python-installer.exe"

2. インストーラーを実行する

.\python-installer.exe /quiet InstallAllUsers=1 PrependPath=1 Include_test=0

3. インストールを確認する

新しいターミナルを開いて、次のコマンドを実行します。

python --version
pip --version

4. uv をインストールする

pip install uv
uv --version

5. リポジトリをクローンする

git clone https://github.com/sanyambassi/ciphertrust-manager-mcp-server.git
cd ciphertrust-manager-mcp-server

6. 仮想環境を作成して依存関係をインストールする

uv venv
.venv\Scripts\activate
uv pip install -e .

方法 2：winget を使用する（Windows）

1. winget で Python をインストールする

winget install --id Python.Python.3.12 --source winget --accept-package-agreements --accept-source-agreements

2. PowerShell を閉じて再度開く

これにより、Python が PATH で使用できるようになります。

3. インストールを確認する

python --version
pip --version

4. uv をインストールする

pip install uv
uv --version

5. リポジトリをクローンする

git clone https://github.com/sanyambassi/ciphertrust-manager-mcp-server.git
cd ciphertrust-manager-mcp-server

6. 仮想環境を作成して依存関係をインストールする

uv venv
.venv\Scripts\activate
uv pip install -e .

設定

（任意）サンプルの環境ファイルをコピーして編集する

.env の例：

cp .env.example .env
# Edit .env with your CipherTrust Manager details

.env ファイルを使わず、環境変数として直接設定することもできます。

.env の内容の例：

CIPHERTRUST_URL=https://your-ciphertrust-manager.example.com
CIPHERTRUST_USER=admin
CIPHERTRUST_PASSWORD=your-password-here
CIPHERTRUST_NOSSLVERIFY=true

使用方法

⚠️ 重要： 起動する前に、環境変数または .env に有効な CipherTrust Manager の URL が設定されていることを確認してください。

CipherTrust MCP サーバーを実行する主な方法は 2 つあります。

方法 1：直接実行

uv run ciphertrust-mcp-server

これにより、ciphertrust_mcp_server/__main__.py の main() 関数が実行されます。

方法 2：モジュールとして実行

uv run python -m ciphertrust_mcp_server.__main__

テスト

このプロジェクトには、Model Context Protocol Inspector と Python の単体テストを使用した包括的なテスト機能が含まれています。

クイックテスト

# Manual JSON-RPC testing (direct stdin/stdout)
uv run ciphertrust-mcp-server
# Then send JSON-RPC commands (see TESTING.md for details)

# Interactive UI (Inspector 2.5+). Open the printed URL; it includes MCP_INSPECTOR_API_TOKEN.
npx @modelcontextprotocol/inspector uv run --no-sync ciphertrust-mcp-server

# Quick CLI testing
# Get tools
npx @modelcontextprotocol/inspector --cli --config tests/mcp_inspector_config.json --server ciphertrust-local --method tools/list --format json
# Get system information
npx @modelcontextprotocol/inspector --cli --config tests/mcp_inspector_config.json --server ciphertrust-local --method tools/call --tool-name system_information --tool-arg action=get --format json
# Get 2 keys
npx @modelcontextprotocol/inspector --cli --config tests/mcp_inspector_config.json --server ciphertrust-local --method tools/call --tool-name key_management --tool-arg action=list --tool-arg limit=2 --format json

利用可能なテスト方法

• 🔧 手動 JSON-RPC テスト：デバッグと開発のための標準入力／標準出力による直接通信
• 🖥️ 対話型 UI テスト：手動テストとデバッグのための視覚的な Web インターフェース
• ⚡ CLI 自動テスト：CI/CD 統合のためのコマンドライン自動化
• 🧪 Python ユニットテスト：サーバーコンポーネントの包括的なユニットテスト
• 🔗 統合テスト：実際の CipherTrust Manager インスタンスを使用したエンドツーエンドテスト

NPM スクリプト

npm run test:inspector:ui     # Open Inspector UI (uses project .env)
npm run test:inspector:cli    # List tools via Inspector CLI
npm run test:python          # Run Python unit tests
npm run test:full           # Run complete test suite

包括的なテストガイド

📖 詳しいテスト手順については、TESTING.mdを参照してください

🔧 AI アシスタントのプロンプト例については、EXAMPLE_PROMPTS.mdを参照してください

テストガイドでは、以下について説明しています。

• セットアップと設定の全手順
• 高度なテストシナリオ

プロンプト例には、以下が含まれています。

• キー管理操作
• ユーザーとグループの管理
• システムとサービスの管理
• クラスター管理
• ライセンス管理
• CTE 操作
• 暗号化操作
• その他の実用的なシナリオ

AI アシスタントとの統合

Cursor での使用

1. Cursor を設定する

• 設定 > MCP Tools > Add Custom MCPに移動します
• 設定ファイル（例：mcp.json）に以下の内容を追加します。

{
  "mcpServers": {
    "ciphertrust": {
      "command": "Path to your project folder/ciphertrust-manager-mcp-server/.venv/bin/ciphertrust-mcp-server",
      "args": [],
      "env": {
        "CIPHERTRUST_URL": "https://your-ciphertrust.example.com",
        "CIPHERTRUST_USER": "admin",
        "CIPHERTRUST_PASSWORD": "your-password-here"
      }
    }
  }
}

Windows では、.venv\Scripts\ciphertrust-mcp-server.exeのパスを使用し、バックスラッシュを二重にします。

{
  "mcpServers": {
    "ciphertrust": {
      "command": "C:\\path\\to\\ciphertrust-manager-mcp-server\\.venv\\Scripts\\ciphertrust-mcp-server",
      "args": [],
      "env": {
        "CIPHERTRUST_URL": "https://your-ciphertrust.example.com",
        "CIPHERTRUST_USER": "admin",
        "CIPHERTRUST_PASSWORD": "your-password-here"
      }
    }
  }
}

2. 設定を適用する

変更を適用するには、Cursor で CipherTrust MCP サーバーを無効にしてから、再度有効にします。

Claude Desktop での使用

1. Claude Desktop の設定ファイルを探すか、作成します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Roaming\Claude\claude_desktop_config.json

2. MCP サーバーの設定を追加または更新します。

macOS/Linux の例：

{
  "mcpServers": {
    "ciphertrust": {
      "command": "/absolute/path/to/ciphertrust-manager-mcp-server/.venv/bin/ciphertrust-mcp-server",
      "env": {
        "CIPHERTRUST_URL": "https://your-ciphertrust.example.com",
        "CIPHERTRUST_USER": "admin",
        "CIPHERTRUST_PASSWORD": "your-password-here"
      }
    }
  }
}

Windows の例：

{
  "mcpServers": {
    "ciphertrust": {
      "command": "C:\\absolute\\path\\to\\ciphertrust-manager-mcp-server\\.venv\\Scripts\\ciphertrust-mcp-server",
      "env": {
        "CIPHERTRUST_URL": "https://your-ciphertrust.example.com",
        "CIPHERTRUST_USER": "admin",
        "CIPHERTRUST_PASSWORD": "your-password-here"
      }
    }
  }
}

実際のプロジェクトの場所と環境に合わせてパスを調整してください。

3. Claude Desktop を再起動する

変更を適用するには、Claude Desktop を再起動します。

環境変数

これらは、シェルまたはプロジェクトのルートにある.envファイルで設定します。

変数名	説明	必須／デフォルト
CIPHERTRUST_URL	CipherTrust Manager の URL（http/https）	必須
CIPHERTRUST_USER	CipherTrust Manager のユーザー名	必須
CIPHERTRUST_PASSWORD	CipherTrust Manager のパスワード	必須
CIPHERTRUST_NOSSLVERIFY	SSL 検証を無効にする（true/false）	false
CIPHERTRUST_TIMEOUT	CipherTrust リクエストのタイムアウト（秒）	30
CIPHERTRUST_DOMAIN	デフォルトの CipherTrust ドメイン	root
CIPHERTRUST_AUTH_DOMAIN	認証ドメイン	root
KSCTL_PATH	ksctl バイナリへのパス	~/.ciphertrust-mcp/ksctl
KSCTL_CONFIG_PATH	ksctl 設定ファイルへのパス	~/.ksctl/config.yaml
LOG_LEVEL	ログレベル（DEBUG、INFO）	INFO

.envファイルの例：

CIPHERTRUST_URL=https://your-ciphertrust.example.com
CIPHERTRUST_USER=admin
CIPHERTRUST_PASSWORD=yourpassword
CIPHERTRUST_NOSSLVERIFY=false
CIPHERTRUST_TIMEOUT=30
CIPHERTRUST_DOMAIN=root
CIPHERTRUST_AUTH_DOMAIN=root
KSCTL_PATH=
KSCTL_CONFIG_PATH=
LOG_LEVEL=INFO

トラブルシューティング

起動が成功した場合のログ：

• このサーバーは、MCP クライアント（Claude Desktop や Cursor など）によってサブプロセスとして実行され、標準入力／標準出力を介した JSON-RPC で通信するように設計されています。
• AI アシスタントの MCP ログには、次のようなログが表示されます。

2025-06-16 02:22:30,462 - ciphertrust_mcp_server.server - INFO - Starting ciphertrust-manager v0.2.0
2025-06-16 02:22:30,838 - ciphertrust_mcp_server.server - INFO - Successfully connected to CipherTrust Manager
2025-06-16 02:22:30,838 - ciphertrust_mcp_server.server - INFO - MCP server ready and waiting for JSON-RPC messages on stdin...

依存関係

pyproject.tomlファイルには、以下の依存関係が含まれています。

• mcp>=2.1.1,<3
• pydantic>=2.12.0
• pydantic-settings>=2.0.0
• httpx>=0.27.0
• python-dotenv>=1.0.0

問題が発生した場合は、すべての依存関係がインストールされ、最新の状態であることを確認してください。

プロジェクト構成

ciphertrust-manager-mcp-server/
├── src
│   ├── ciphertrust_mcp_server/     # Main server code
├── tests/                      	# Testing configuration and unit tests
│   ├── mcp_inspector_config.json
│   ├── test_scenarios.json
│   ├── test_server.py
│   └── test_integration_simple.py
├── scripts/                    	# Testing and utility scripts
│   ├── test_with_inspector.bat
│   ├── test_with_inspector.sh
│   └── run_tests.py
├── docs/                      		# Additional documentation
│   ├── TESTING.md
│   ├── EXAMPLE_PROMPTS.md
│   └── TOOLS.md
├── README.md                   	# This file
├── pyproject.toml             		# Python dependencies
└── package.json               		# Node.js dependencies for testing

貢献

貢献を歓迎します！お気軽にプルリクエストをお送りください。個人プロジェクトとして始まりましたが、皆さんからの貢献によって、より良いものになります。

法的事項

商標に関する通知

CipherTrust®および関連する商標は、Thales Group とその子会社の所有物です。このプロジェクトは、Thales Group と提携、承認、または後援を受けていません。

無保証

このソフトウェアは、いかなる種類の保証もなく「現状有姿」で提供されます。ご自身の責任でご使用ください。

サポート

これは独立したプロジェクトです。CipherTrust Manager の公式サポートについては、Thales に直接お問い合わせください。この非公式 MCP サーバーに関する問題については、GitHub の課題トラッカーをご利用ください。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については、LICENSE ファイルをご覧ください。

---