Command MCP

🚀 Command - MCP

Command - MCPは、Keyfactor Analytics & AIチームのPython SDKをベースに構築されたCommand用のMCPサーバーです。このプレビュー版は実験的なソフトウェアであり、AIツールに本番環境のデータへのアクセスを許可することは推奨されません。このソフトウェアは現状のまま提供され、このMCPサーバーに対してはサポートSLAは適用されません。

🚀 クイックスタート

Command - MCPを使用する前に、いくつかの前提条件を満たす必要があります。また、インストール手順を正しく実行することで、サーバーを正常に起動できます。

✨ 主な機能

Command - MCPは、Keyfactor Commandと連携して、証明書の管理や操作を行うことができます。以下の操作がサポートされています。

1. get_license：Keyfactor Commandの機能ライセンスに関する情報を取得し、基本的な接続テストとして機能します。必要な権限：なし。
2. get_certificate_details_by_id：証明書IDによって証明書と関連するメタデータを取得します。Command Risk Intelligenceが有効な場合、リスクデータも含まれます。必要な権限：Certificates: Collections: Read。
3. enroll_certificate：指定されたサブジェクトとDNS SANを使用してPFX登録を行います。必要な権限：Certificates: Enrollment: PFX。
4. enroll_csr：MCPクライアントに提供されたCSRを使用して登録を行います。必要な権限：Certificates: Enrollment: CSR。
5. revoke_certificate：証明書IDによって証明書を取り消します。必要な権限：Certificates: Collections: Revoke。
6. get_metadata_fields：Commandに存在するすべてのメタデータフィールドと定義のリストを取得します。必要な権限：Metadata: Types: Read。
7. query_certificates：証明書検索クエリを実行して、一致する証明書を取得し、ソートなどの追加オプションがあります。必要な権限：Certificates: Collections: Read。
8. get_module_info_for_mcp：Command APIを使用せずに、Command MCPサーバーを説明する静的定義を返します。

📦 インストール

1. このリポジトリをダウンロードします。この手順では、"C:\mcp"にダウンロードすることを想定しています。
2. Commandで、使用する予定の操作を実行するために必要な権限を持つアカウントを作成または特定します。
3. 環境変数をC:\mcp\mcpenv.txtに記述します。それぞれ1行ずつ、Command環境と作成したアカウントの情報を使用します。
   • 基本認証:

     KEYFACTOR_HOSTNAME='...'
     KEYFACTOR_TOKEN='...'
     KEYFACTOR_TEMPLATE='WebServer'
     KEYFACTOR_CA='kftrain.keyfactor.lab\\keyfactor - KFTRAIN - CA'
     

   • OAuth:

     KEYFACTOR_HOSTNAME=...
     KEYFACTOR_URLBASE=Keyfactor/API
     COMMAND_IDP_TOKENURL=...
     COMMAND_IDP_CLIENTID=...
     COMMAND_IDP_CLIENTSECRET=...
     COMMAND_IDP_AUDIENCE=...
     KEYFACTOR_TEMPLATE=Server_tlsServerAuth - 1y
     KEYFACTOR_CA=http://ejbca - ca.jdk - 2025 - may.svc.cluster.local:8082/ejbca\\Sub - CA
     

4. 次のコマンドを実行します（pipがPython 2.xを指している場合は、"pip3"を使用する必要がある場合があります）。

   pip install requests oauthlib httpx attrs python - dateutil uv
   

5. このコマンドがCLIから実行でき、"Initializing MCP server"と表示されることをテストします。

   uv --directory C:\\mcp run --env - file=C:\\mcp\\mcpenv.txt commandmcp.py
   

6. Claudeで、Ctrl + Commaを押して設定を開き、開発者セクションに移動して、"edit config"をクリックします。移動先のフォルダのclaude_desktop_config.jsonに以下を記述します。

   {
       "mcpServers": {
           "keyfactorCommand": {
               "command": "uv",
               "args": [
                   "--directory",
                   "C:\\mcp",
                   "run",
                   "--env - file=C:\\mcp\\mcpenv.txt",
                   "commandmcp.py"
               ]
           }
       }
   }
   

7. Claudeで、設定 -> 統合に移動し、有効にする操作とClaudeが許可を求めるタイミングについて希望の選択を行います。少なくとも、登録と取り消し機能の各使用前にClaudeに許可を求めることをお勧めします。

📚 ドキュメント

前提条件

• Keyfactor Commandバージョン11以上
• Claude for Desktop
• Python 3

注意事項

• ⚠️ このプレビューソフトウェアは実験的なものと見なされており、本番環境での使用は推奨されません。
• セキュリティ上の理由から、このMCPサーバーはClaude for Desktopのようなクライアントに対してローカルMCPサーバーとして展開されます。
• 登録に使用するテンプレートとCAパラメータは、MCPサーバーの環境変数として指定する必要があり、MCPクライアントを意図した登録タイプに限定します。このテンプレートとCAには、権限と可用性を設定する必要があります。
• 実装された操作の詳細については、"commandmcp.py"のコメントを参照するか、MCPクライアントに問い合わせてください。
• Keyfactor Commandと必要な権限に関する情報は、[Keyfactor Command Reference Guide](https://software.keyfactor.com/Core - Hosted/v25.1.1/Content/ReferenceGuide/Introduction.htm)を参照してください。