MCP 集成

你将学到什么

Verdent for VS Code 中 Model Context Protocol (MCP) 集成的概览，包括设置、配置和可扩展性选项。

什么是 MCP（Model Context Protocol）？

Model Context Protocol (MCP) 是一个集成系统，通过连接到外部工具、数据源和服务来扩展 Verdent 的能力。

核心概念： MCP 让 Verdent 能够与其内置工具集之外的系统进行交互，从而实现与以下系统的无缝集成：

• 外部 API 和 Web 服务
• 数据库系统
• 云平台（AWS、Azure、GCP）
• 项目管理工具
• CI/CD 流水线
• 自定义内部工具

架构： MCP 服务器充当 Verdent 与外部系统之间的桥梁。每个 MCP 服务器都暴露特定能力，Verdent 可以在编码会话期间调用这些能力，类似于 file_read 或 bash 等内置工具。

配置存储： MCP 服务器配置存储在 ~/.verdent/mcp.json 中，并通过设置菜单进行管理。

MCP 集成的优势

扩展能力

访问外部系统： 将 Verdent 连接到内置功能无法提供的工具和服务。无需离开编码工作流，即可查询数据库、与云服务交互或集成特定于项目的 API。

自定义工具开发： 创建专门针对你项目独特需求的 MCP 服务器。为内部工具、专有 API 或特定领域系统构建专门的集成。

互操作性

生态系统优势： 接入不断壮大的 MCP 生态系统。社区开发的 MCP 服务器为热门工具和服务提供了预构建的集成。

标准化协议： MCP 为工具集成提供一致的接口，确保新能力能与 Verdent 现有的工具系统顺畅整合。

工作流自动化

无缝集成： MCP 服务器会成为 Verdent 工具集的一部分。智能体会在适当时自动使用 MCP 工具，你也可以针对特定任务显式调用它们。

上下文感知操作： MCP 集成能够理解你的代码库上下文，从而基于当前开发状态智能地与外部系统交互。

设置 MCP 服务器

配置流程

访问 MCP 设置：

1. 在 Verdent 中打开设置菜单
2. 导航到 MCP Servers 部分
3. 查看或修改 ~/.verdent/mcp.json 配置

配置文件： MCP 服务器通过 ~/.verdent/mcp.json 文件进行配置，该文件定义了服务器连接、身份验证和集成参数。

配置管理

添加服务器： 通过在 mcp.json 中添加包含连接详情和身份验证凭据的条目来配置新的 MCP 服务器。

多个服务器： Verdent 支持多个并发的 MCP 服务器，允许同时与多个外部系统集成。

测试连接： 在开发工作流中使用 MCP 服务器之前，验证其配置以确保连接成功。

MCP 插件和扩展

可用插件

MCP 插件为常见工具和服务提供预构建的集成。

预期插件类别：

• 数据库集成： PostgreSQL、MySQL、MongoDB 查询工具
• 云服务： AWS、Azure、GCP API 交互
• 开发者工具： GitHub、GitLab、Jira、Linear 集成
• CI/CD 平台： Jenkins、GitHub Actions、CircleCI
• 监控服务： Datadog、New Relic、Sentry
• 通信： Slack、Discord、Microsoft Teams 通知

插件安装

安装方法： 插件通过 MCP 设置界面进行安装和配置，通常需要：

• 插件标识符或来源
• 配置参数
• 身份验证凭据（如适用）

依赖管理： MCP 插件可能依赖外部服务或库。安装过程会在可能的情况下自动处理依赖解析。

自定义 MCP 服务器开发

创建自定义服务器

高级用户可以创建自定义 MCP 服务器，以集成专有工具或特定领域的系统。

开发方法： 自定义 MCP 服务器实现 MCP 协议规范，暴露 Verdent 可以调用的工具能力。

自定义服务器的使用场景：

• 内部 API 集成： 连接到公司专属的 API 和服务
• 遗留系统桥接： 让 Verdent 能够与遗留基础设施交互
• 专门数据源： 访问专有数据库或数据仓库
• 工作流自动化： 触发自定义的构建、部署或测试流水线

集成模式

工作区级别配置： MCP 服务器可以在工作区级别进行配置以实现特定于项目的集成，使团队能够通过版本控制共享 MCP 配置。

工具互操作性： MCP 提供的工具与 Verdent 的内置工具（file_read、bash、spawn_subagent）无缝集成，从而支持组合多种工具类型的复杂工作流。

MCP 工作流示例

数据库查询集成

场景： 查询生产数据库以调试数据问题。

MCP 方法：

User: "Check the orders table for customer ID 12345"
Verdent: [Uses MCP database server to execute safe read-only query]
        Results: 3 orders found for customer 12345
        [Displays formatted results]

MCP 数据库服务器负责处理身份验证、查询验证和结果格式化。

云服务交互

场景： 检查 AWS Lambda 函数日志中的错误。

MCP 方法：

User: "Show me recent errors from the payment-processor Lambda function"
Verdent: [Invokes MCP AWS integration]
        [Retrieves CloudWatch logs for specified function]
        [Filters for ERROR level entries]
        [Presents formatted error summaries]

MCP AWS 服务器负责管理身份验证、API 调用和日志解析。

CI/CD 流水线监控

场景： 在部署变更前检查构建状态。

MCP 方法：

User: "Is the main branch build passing?"
Verdent: [Queries MCP CI/CD integration]
        Build #245: ✓ Passed (2 minutes ago)
        All tests passed, ready for deployment

MCP CI/CD 服务器跟踪流水线状态并提供实时反馈。

安全注意事项

身份验证与授权

凭据管理： MCP 服务器负责处理对外部服务的身份验证。凭据安全地存储在 MCP 配置中，绝不会暴露在聊天历史或代码中。

权限范围限定： 为 MCP 服务器配置最低限度的必要权限。尽可能使用只读访问，并限制破坏性操作。

安全操作

命令审查： 涉及 MCP 工具的操作可以在 Manual Accept Mode 下于执行前进行审查，提供可见性和控制力。

审计日志： MCP 服务器操作会出现在 Verdent 的聊天历史中，从而为外部系统交互创建审计轨迹。

MCP 集成故障排查

常见问题

连接失败：

• 验证到 MCP 服务器的网络连接
• 检查 mcp.json 中的身份验证凭据
• 确保 MCP 服务器正在运行且可访问
• 验证配置文件语法

权限错误：

• 确认 API 密钥或凭据具有所需权限
• 检查服务配额或速率限制
• 验证防火墙规则允许 MCP 流量

工具调用问题：

• 确保 MCP 服务器正确暴露了预期的工具
• 检查工具参数格式是否符合服务器预期
• 查看 MCP 服务器日志以获取错误详情

获取帮助

支持渠道：

• Verdent 支持：support@verdent.ai
• MCP 协议文档
• Verdent Discord 社区，获取实时支持

诊断信息： 报告 MCP 问题时，请提供：

• MCP 服务器类型和版本
• 配置详情（移除凭据后）
• 聊天历史中的错误消息
• MCP 服务器日志（如可访问）

MCP 文档资源

官方文档

即将推出：

• 分步 MCP 服务器设置指南
• 插件安装和配置演练
• 自定义服务器开发教程
• MCP 集成最佳实践
• MCP 工作流的性能优化

临时资源

当前 MCP 信息：

• MCP 协议规范（外部）
• 社区开发的 MCP 服务器和示例
• MCP 生态系统 GitHub 仓库

联系获取详情： 如需立即获得 MCP 集成帮助，请联系 support@verdent.ai，并说明你的具体使用场景和集成需求。

参见