科迈特尔-MCP服务器
项目介绍
Commvault MCP Server
一个用于与Commvault环境无缝集成的模型上下文协议(MCP)服务器。此服务器使AI代理能够安全地访问和管理作业详情、Commcell指标、客户端和存储信息、用户权限、计划配置以及备份时间表。
功能
Commvault MCP Server实现了与Commvault环境的无缝集成，提供以下功能：
| 类别 | 功能 |
|---|---|
| 作业管理 | • 查看作业详情和历史记录<br>• 控制作业（暂停、恢复、重新提交、终止）<br>• 监控作业状态和性能 |
| Commcell管理 | • 获取SLA状态和合规性<br>• 查看安全态势和评分<br>• 访问存储空间利用率指标<br>• 获取Commcell详情和实体数量 |
| 客户端管理 | • 访问客户端组和客户端信息<br>• 管理子客户端和客户端属性<br>• 查看客户端关联 |
| 存储管理 | • 查看存储策略和配置<br>• 访问存储池信息<br>• 监控存储资源 |
| 用户管理 | • 列出用户和用户组<br>• 访问安全关联<br>• 管理用户权限 |
| 计划管理 | • 查看计划配置和详情<br>• 访问计划组件和设置 |
| 时间表管理 | • 访问备份时间表<br>• 查看时间表配置<br>• 监控时间表性能 |
| DocuSign集成 | • 设置Docusign Vault & 工作流<br>• 将信封备份到Commvault S3存储库<br>• 列出并恢复DocuSign信封备份 |
先决条件
在运行Commvault MCP Server之前，请确保满足以下要求：
1. Python环境
- Python 3.11或更高版本
- 依赖管理和运行服务器的包管理器
uv
2. 认证与安全配置
Commvault MCP Server支持两种认证方法：
<details> <summary>选项1：OAuth认证</summary> <br/>注意： OAuth认证仅支持运行SP42 CU 27及更高版本的Commvault环境。 在使用此选项之前，必须在CommServe中正确配置OAuth。
使用OAuth认证时，您需要：
- 发现端点URL： OAuth发现/元数据端点
- 客户端ID： 您的OAuth应用程序的客户端标识符
- 客户端密钥： 您的OAuth应用程序的客户端密钥
- 所需范围： 所需的OAuth范围
- 基础URL： MCP服务器的基础URL
</details> <details> <summary>选项2：传统的基于令牌的认证</summary> <br/>重要： 重定向URI必须设置为
OAUTH_BASE_URL/auth/callback，在您的OAuth提供商的应用/客户端配置中。
在设置过程中会收集以下值：
-
Commvault访问凭证： 您需要有效的
access_token和refresh_token来通过Commvault API进行身份验证。 了解如何生成这些令牌：创建访问令牌 – Commvault文档 -
密钥： 此密钥必须由MCP客户端包含在所有工具请求的
Authorization头中。 它作为远程服务器上工具访问的安全层。您可以自行设置。
配置
1. 克隆仓库
git clone https://github.com/Commvault/commvault-mcp-server.git
cd commvault-mcp-server
2. 运行设置脚本
设置脚本将引导您完成配置选项，包括：
- 传输模式（stdio、streamable-http或sse）
- 服务器连接详情（对于远程模式）
- 认证方法（传统令牌或OAuth）
- OAuth配置（如果选择）
- 安全令牌存储
uv run setup.py
3. 启动MCP服务器
uv run -m src.server
配置客户端
<details> <summary>使用OAuth时</summary> <br/>注意： 使用Token-Based认证时需要
npx。您可以通过安装Node.js获得它，默认情况下包含npx。
请参阅您的AI客户端文档中的集成步骤。例如，Claude需要在其连接器配置中指定服务器名称和MCP服务器URL。
</details> <details> <summary>远程MCP服务器（Streamable HTTP / SSE）</summary>{
"mcpServers": {
"Commvault": {
"command": "npx",
"args": ["mcp-remote", "HOST:PORT/mcp", "--header", "Authorization: <存储在服务器密钥环中的密钥>"]
}
}
}
{
"mcpServers": {
"Commvault": {
"command": "cmd",
"args": ["/c", "npx", "mcp-remote", "HOST:PORT/mcp", "--header", "Authorization: <存储在服务器密钥环中的密钥>"]
}
}
}
{
"mcpServers": {
"Commvault": {
"command": "npx",
"args": ["mcp-remote", "HOST:PORT/mcp", "--header", "Authorization: <存储在服务器密钥环中的密钥>", "--allow-http"]
}
}
}
{
"mcpServers": {
"Commvault": {
"command": "C:\\YOUR\\PATH\\TO\\commvault-mcp-server\\.venv\\bin\\python",
"args": [
"C:\\YOUR\\PATH\\TO\\commvault-mcp-server\\src\\server.py"
]
}
}
}
{
"mcpServers": {
"Commvault": {
"command": "C:\\YOUR\\PATH\\TO\\commvault-mcp-server\\.venv\\Scripts\\python.exe",
"args": [
"C:\\YOUR\\PATH\\TO\\commvault-mcp-server\\src\\server.py"
]
}
}
}
额外配置
<details> <summary>DocuSign备份集成</summary> <br/>注意： 这些是可选集成，扩展了MCP服务器的功能。
DocuSign备份集成允许将已完成的DocuSign信封备份到Commvault S3存储库。此集成提供了全面的文档管理能力，包括备份、列出和恢复操作。
先决条件
- 环境变量：在环境中设置
ENABLE_DOCUSIGN_TOOLS=true - Commvault S3存储库：在Commvault中配置S3端点
- 了解更多：开始使用S3存储库
- DocuSign API访问：有效的DocuSign集成凭证
配置文件
在config/目录下创建以下文件：
1. DocuSign配置（docusign_config.json）
基于模板文件config/docusign_config_template.json：
{
"docusign": {
"integrationKey": "YOUR_INTEGRATION_KEY_HERE",
"userId": "YOUR_USER_ID_HERE",
"authServer": "account-d.docusign.com",
"scopes": "signature impersonation",
"basePath": "https://demo.docusign.net/restapi"
},
"fromDate": "2024-07-01T00:00:00Z"
}
2. DocuSign私钥（docusign_key.pem）
将您的DocuSign私钥文件放置在config/目录下，命名为docusign_key.pem。
贡献
- 我们正在继续为这个MCP服务器添加更多功能。如果您希望提供反馈、报告错误或提出功能请求，请在此仓库中打开一个问题。
- 欢迎Pull Requests！对于重大更改，请先打开一个问题讨论您想要更改的内容。
许可证
此项目根据Apache许可证发布。查看LICENSE文件以获取详细信息。