MCP 集成

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost:5432/myapp_dev"
      ]
    }
  }
}

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost:5432/myapp_dev"
      ]
    },
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

配置键：

mcpServers - MCP 配置的必需顶层键
command - 要运行的可执行文件（Node.js 包通常为 npx）
args - 传递给命令的参数（包名、连接字符串等）
env - 用于认证/配置的环境变量

了解更多 MCP 信息：

Model Context Protocol 规范
MCP 服务器注册表 - 浏览可用的 MCP 服务器
官方 MCP 服务器 - PostgreSQL、GitHub、Filesystem 等

MCP 插件和扩展

可用插件

MCP 插件为常见工具和服务提供预构建的集成。可在社区注册表 mcp.so/servers 或官方 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 可调用的工具能力。有关实现细节和 SDK，请参阅 Model Context Protocol 规范。

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

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

集成模式

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

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

桌面端专属 MCP 功能

按项目配置

配置级别	位置	作用范围
全局	`~/.verdent/mcp.json`	所有项目
项目	项目根目录中的 `.mcp.json`	单个项目
Worktree	继承自项目	继承项目配置

多 Worktree MCP

MCP 服务器可跨 worktree 工作：

共享服务器： 基础工作区的 MCP 配置由所有 worktree 共享
隔离操作： 每个 worktree 维护独立的 MCP 会话状态
并行访问： 多个 worktree 可并发使用同一个 MCP 服务器

项目切换

切换项目时：

当前项目的 MCP 服务器会被加载
全局 MCP 服务器始终可用
上一个项目的 MCP 连接会在后台保持

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 master branch build passing?"
Verdent: [Queries MCP CI/CD integration]
        Build #245: ✓ Passed (2 minutes ago)
        All tests passed, ready for deployment

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