内容
# 网络安全开发工具
[](https://pypi.org/project/cybersource-developer-mcp/)
[](https://pypi.org/project/cybersource-developer-mcp/)
[](https://pypi.org/project/cybersource-developer-mcp/)
**PyPI**: [https://pypi.org/project/cybersource-developer-mcp/](https://pypi.org/project/cybersource-developer-mcp/)
让 AI 直接在您的应用程序中编写 CyberSource 集成代码。该 MCP 服务器提供实时的 SDK 文档和代码生成协助，使您的 AI 助手能够帮助您使用官方 SDK 集成任何 CyberSource API。
## 什么是此工具？
此 MCP（模型上下文协议）服务器将您的 AI 助手连接到实时的 CyberSource SDK 文档。您的 AI 不需要手动搜索文档，而是可以：
- **直接编写代码**，用于 CyberSource API 集成
- **访问实时** SDK 文档、方法签名和模型
- **生成工作代码**，使用官方 CyberSource SDK
- **代码生成**：支持 **Java**、**Python**、**Node.js**、**PHP** 和 **Ruby**（其他语言即将支持）
- **MLE 支持**：帮助您集成或升级到 CyberSource 要求的消息级加密（MLE），并提供每个 API 的 MLE 要求详细信息
您的 AI 助手成为 CyberSource 集成专家，在您的应用程序中编写生产就绪的代码。
## 快速设置
### 1. 安装服务器
#### 选项 1：使用 pipx（推荐 - 自动隔离）
pipx 自动创建隔离环境，防止依赖冲突：
```bash
# 安装 pipx（一次性设置）
pip install pipx
pipx ensurepath
# 安装 CyberSource 开发人员 MCP
pipx install cybersource-developer-mcp
# 验证安装
cybersource-developer-mcp --help
```
**为什么使用 pipx？**
- ✅ 自动环境隔离（无需手动 venv 管理）
- ✅ 与其他 Python 包的依赖冲突为零
- ✅ MCP 服务器的标准方法
- ✅ 简单的一命令安装
#### 选项 2：使用 uvx（现代替代品）
uvx 允许在无需安装的情况下运行服务器：
```bash
# 安装 uv（一次性设置）
pip install uv
# 直接运行（无需安装步骤！）
uvx cybersource-developer-mcp start
# 使用选项
uvx cybersource-developer-mcp start --data-dir /custom/path --enable-logging
```
**为什么使用 uvx？**
- ✅ 无需安装步骤
- ✅ 自动隔离
- ✅ 非常快的执行速度
- ✅ 现代工具
#### 选项 3：使用 pip（不推荐，无虚拟环境）
如果您更喜欢 pip，请先创建虚拟环境以避免冲突：
```bash
# 创建并激活虚拟环境
python -m venv mcp-env
source mcp-env/bin/activate # Windows: mcp-env\Scripts\activate
# 安装包
pip install cybersource-developer-mcp
# 验证安装
cybersource-developer-mcp --help
```
**注意：** 在没有虚拟环境的情况下使用 pip 可能会导致与其他包的依赖冲突。
### 2. 配置您的 AI 助手
#### 对于 Cline（VS Code 扩展）
**标准配置**（适用于 pipx 或 pip 安装）：
```json
{
"mcpServers": {
"cybersource-developer-mcp": {
"timeout": 300,
"command": "cybersource-developer-mcp",
"args": ["start"],
"env": {}
}
}
}
```
> **💡 关于超时时间**：当您第一次询问特定 SDK 语言时，服务器需要获取和准备文档，这可能需要几分钟（例如，PHP 可能需要 ~3 分钟）。300 秒的超时时间确保此初始设置完成而不会中断。之后，所有响应都是瞬间的，因为所有内容都缓存在本地。
**使用 uvx**（无需安装）：
```json
{
"mcpServers": {
"cybersource-developer-mcp": {
"timeout": 300,
"command": "uvx",
"args": ["cybersource-developer-mcp", "start"],
"env": {}
}
}
}
```
**使用自定义数据目录**：
```json
{
"mcpServers": {
"cybersource-developer-mcp": {
"type": "stdio",
"command": "cybersource-developer-mcp",
"args": ["start", "--data-dir", "/custom/path"],
"env": {}
}
}
}
```
**启用日志记录**：
```json
{
"mcpServers": {
"cybersource-developer-mcp": {
"type": "stdio",
"command": "cybersource-developer-mcp",
"args": ["start", "--enable-logging"],
"env": {}
}
}
}
```
#### 对于 Claude Desktop
将以下内容添加到您的 Claude Desktop MCP 配置中：
```json
{
"mcpServers": {
"cybersource-developer-mcp": {
"type": "stdio",
"command": "cybersource-developer-mcp",
"args": ["start"],
"env": {}
}
}
}
```
### 3. 开始使用
就这样！您的 AI 助手现在可以帮助您进行 CyberSource 集成。只需询问：
- “显示如何使用 CyberSource Java SDK 创建付款”
- “PaymentsApi 接受哪些参数？”
- “帮助我为 CyberSource 设置身份验证”
- “在 Python 中生成付款捕获示例”
## 它能做什么？
### 🔍 SDK API 文档
获取任何 CyberSource API 类的 SDK 完整文档，包括方法签名、参数和示例。
**示例**：询问“PaymentsApi 中有哪些方法可用？”
### 📦 模型详细信息
了解请求和响应模型，包括属性定义和数据类型。
**示例**：询问“PaymentRequest 需要哪些字段？”
### 📋 API 发现
浏览所有可用的 CyberSource API，包括端点映射和描述。
**示例**：询问“有哪些 API 可用于支付处理？”
### 📖 设置指南
访问 SDK 安装、身份验证和配置文档。
**示例**：询问“如何在 Java 中设置 CyberSource 身份验证？”
### 🔐 MLE（消息级加密）支持
识别哪些 API 需要或支持 MLE（由 CyberSource 强制执行）。获取有关使用 CyberSource SDK 集成或升级现有代码以满足 MLE 要求的指导，包括每个 API 的 MLE 配置详细信息。
**示例**：询问“哪些 API 需要 MLE？”或“帮助我为 Payments API 启用 MLE”
### 💻 代码模板
获取常见集成模式的代码结构模板。
**示例**：询问“显示一个基本的付款集成模板”
## 配置选项
### 自定义数据目录
默认情况下，SDK 下载到 `~/.cybersource_developer_mcp/`。要使用不同的位置：
```json
{
"mcpServers": {
"cybersource-developer-mcp": {
"command": "cybersource-developer-mcp",
"args": ["start", "--data-dir", "/your/custom/path"]
}
}
}
```
### 启用日志记录
要启用详细日志记录进行故障排除：
```json
{
"mcpServers": {
"cybersource-developer-mcp": {
"command": "cybersource-developer-mcp",
"args": ["start", "--enable-logging"]
}
}
}
```
日志将保存到 `~/.cybersource_developer_mcp/logs/mcp_server.log`
### GitHub Token（可选）
为了更快地下载 SDK 和更高的 API 请求限制，请添加 GitHub token：
```json
{
"mcpServers": {
"cybersource-developer-mcp": {
"command": "cybersource-developer-mcp",
"args": ["start"],
"env": {
"GITHUB_TOKEN": "your_github_token_here"
}
}
}
}
```
## 它是如何工作的？
1. **首次**：当您询问 CyberSource API 时，服务器会自动下载 SDK 文档
2. **缓存**：后续请求是瞬间的 - 无需重新下载
3. **始终当前**：服务器可以检查并使用最新的 SDK 版本
4. **多语言**：适用于 Java、Python、PHP、Node.js 和 Ruby（.NET 和 .NET Standard 即将推出）
## 要求
- **Python 3.10 或更高版本**
- **互联网连接**（用于初始 SDK 下载）
- **Windows 用户**：启用长路径支持（参见下面的 [Windows 长路径修复](#windows-long-path-errors)）
## 故障排除
### 服务器无法启动
1. 检查 Python 版本：`python --version`（必须是 3.10+）
2. 根据您的安装方法重新安装：
- **pipx**：`pipx reinstall cybersource-developer-mcp`
- **pip**：`pip install --upgrade cybersource-developer-mcp`
- **uvx**：只需重新运行 `uvx cybersource-developer-mcp start`
3. 检查日志：`~/.cybersource_developer_mcp/logs/mcp_server.log`（如果启用了日志记录）
### AI 助手无法找到 API
1. 确保服务器在您的 MCP 配置中运行
2. 在添加配置后重启您的 AI 助手
3. 尝试询问“列出最新版本的可用 CyberSource API”
### SDK 下载问题
1. 检查互联网连接
2. 验证 GitHub 是否可访问
3. 添加 GitHub token（参见上面的配置选项）
4. 检查 `~/.cybersource_developer_mcp/` 中的磁盘空间
### Windows 长路径错误
Windows 默认路径长度限制为 260 个字符。启用长路径支持：
1. 打开注册表编辑器（regedit）
2. 导航到：`HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem`
3. 将 `LongPathsEnabled` 设置为 `1`
4. 重启计算机
或在提升的 PowerShell 中运行：`New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force`
### 企业网络问题
如果您在企业代理或防火墙后面：
```bash
# 设置自定义 CA 捆绑
export REQUESTS_CA_BUNDLE=/path/to/corporate/ca-bundle.crt
```
然后将此添加到您的 MCP 配置中：
```json
{
"env": {
"REQUESTS_CA_BUNDLE": "/path/to/corporate/ca-bundle.crt"
}
}
```
## 示例对话
以下是使用此工具与 AI 助手的一些方法：
**基本付款集成**
> “我需要使用 CyberSource Java SDK 创建付款。给我看看。”
**了解 API**
> “PaymentsApi 和 CaptureApi 之间有什么区别？”
**模型详细信息**
> “PaymentRequest 模型需要哪些字段？”
**身份验证设置**
> “如何为 CyberSource 配置 HTTP 签名身份验证？”
**多步骤集成**
> “帮助我使用 Python 构建一个完整的支付流程，包括授权和捕获。”
**版本特定帮助**
> “显示 PaymentsApi 的 0.0.82 版本的文档。”
**MLE 集成**
> “哪些 CyberSource API 需要 MLE 以及如何在我的 SDK 配置中启用它？”
**MLE 升级**
> “帮助我将现有的付款集成升级为支持 MLE（由 CyberSource 强制执行）。”
## 数据存储
服务器默认情况下将数据存储在 `~/.cybersource_developer_mcp/` 中：
```
~/.cybersource_developer_mcp/
├── cybs-sdk-github-code/ # 下载的 SDK 文档
├── pre-processed-json/ # 缓存的详细信息
└── logs/ # 服务器日志（如果启用）
```
您可以安全地删除此目录以重新开始。服务器将重新下载所需的内容。
## 支持的 SDK 语言
| 语言 | SDK 文档 | 代码生成 | 最新版本自动检测 |
|----------|---------------|-----------------|------------------------------|
| Java | ✅ 完整支持 | ✅ 可用 | 是 |
| Python | ✅ 完整支持 | ✅ 可用 | 是 |
| PHP | ✅ 完整支持 | ✅ 可用 | 是 |
| Node.js | ✅ 完整支持 | ✅ 可用 | 是 |
| Ruby | ✅ 完整支持 | ✅ 可用 | 是 |
| .NET | 🚧 即将推出 | 🚧 即将推出 | 是 |
| .NET Standard | 🚧 即将推出 | 🚧 即将推出 | 是 |
**注意**：Java、Python、Node.js、PHP 和 Ruby 的 SDK 文档和代码生成模板可用。.NET 和 .NET Standard 的支持即将推出。
## 隐私和安全
- **不发送数据**：您的代码和对话在您和 AI 助手之间进行
- **本地存储**：所有 SDK 和文档都存储在您的本地机器上
- **GitHub 访问**：仅下载公共 CyberSource SDK 仓库
- **可选令牌**：GitHub 令牌仅需用于更高的下载限制
## 需要帮助？
- **问题**：在 [GitHub 问题](https://github.com/CyberSource/cybersource-developer-mcp/issues) 上报告问题
- **更新**：在 [CHANGELOG.md](https://github.com/CyberSource/cybersource-developer-mcp/blob/master/CHANGELOG.md) 中查看版本历史
## 链接
- **MCP 文档**：https://modelcontextprotocol.io
- **CyberSource 开发者中心**：https://developer.cybersource.com
- **GitHub 仓库**：https://github.com/CyberSource/cybersource-developer-mcp
---
**注意**：此 MCP 服务器提供 SDK 文档和代码协助。对于生产实施，请始终参考官方 CyberSource 文档并遵循安全最佳实践。
## AI 生成代码免责声明
**重要**：此工具使用 AI 协助代码生成和文档。请注意：
- **无责任**：CyberSource 不对使用此 MCP 服务器的 AI 助手生成的任何代码负责
- **需要验证**：您必须彻底审查、测试和验证所有 AI 生成的代码，然后再使用
- **您的责任**：确保生成的代码符合您的安全、合规性和业务要求
- **测试必填**：所有代码必须在生产环境部署前在非生产环境中进行测试
- **安全审查**：进行适当的安全审查并遵循组织的代码审查流程
- **无担保**：生成的代码“按原样”提供，不提供任何正确性、安全或适用于任何目的的保证
**最佳实践**：
- 始终逐行审查生成的代码
- 在开发和暂存环境中进行彻底测试
- 遵循组织的安全和合规指南
- 保持凭证和敏感数据安全（永远不要在代码中公开 API 密钥）
- 咨询官方 CyberSource 文档以获取权威指导
- 与 CyberSource 支持团队接洽生产关键实现
