Keyfactor Command MCP Server

⚠️预览版：不建议用于生产环境

Command-MCP

基于 Keyfactor Analytics & AI 团队的 Python SDK 构建的 Command MCP 服务。此预览版软件处于实验性阶段，不建议用户向 AI 工具提供生产数据的访问权限。本软件按“原样”提供，此 MCP 服务不适用支持 SLA。

前提条件

1. Keyfactor Command 11 或更高版本
2. Claude for Desktop
3. Python 3

操作和所需权限

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 Server 的静态定义。

安装

1. 下载此仓库。以下说明假设下载到 "C:\mcp"。
2. 在 Command 中创建或找到一个具有执行你要使用的任何操作所需权限的账户。
3. 将环境变量写入 C:\mcp\mcpenv.txt。每行一个，使用 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 打开设置，进入 developer，然后点击 "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 中，进入 Settings->Integration，选择要启用的操作，并设置 Claude 何时应请求权限。建议至少设置为在每次使用申请和撤销功能之前都询问。

备注

• ⚠️ 此预览版软件属于实验性软件，不建议用于生产环境。
• 出于安全考虑，此 MCP 服务以本地 MCP 服务的形式部署到 Claude for Desktop 等客户端。
• 必须将注册所用的模板和 CA 参数指定为 MCP 服务的环境变量，以便将 MCP 客户端限制为仅使用预期的注册类型。必须在此模板和 CA 上设置权限和可用性。
• 如需了解已实现操作的更多详情，请参阅“commandmcp.py”中的注释，或向 MCP 客户端询问。
• 有关 Keyfactor Command 和所需权限的信息，请参阅 Keyfactor Command 参考指南。