跳转到内容
案例 生态 源码解读 文档

MCP 服务器实战案例

通过接入 MCP（Model Context Protocol）服务器，赋予 OpenCode 现实世界的能力——直接从智能体查询数据库、驱动浏览器或调用外部 API。

何时使用此案例

  • 希望智能体基于实时数据（数据库、浏览器、API）行动，而非粘贴的文本。
  • 正在构建跨越多个工具的自动化。
  • 需要智能体先读取、再决策、再行动。

前置配置

  • 已安装 OpenCode。
  • 一个目标 MCP 服务器（例如用于浏览器控制的 Playwright，或用于查询的 Postgres MCP）。

步骤

  1. 添加 MCP 服务器配置

    在 OpenCode 配置中注册该服务器。

    {
  "mcp": {
    "playwright": {
      "type": "local",
      "command": ["npx", "@playwright/mcp@latest"]
    }
  }
}

  2. 确认工具已加载

    启动 OpenCode，让它列出可用工具——你应该看到该服务器的工具（如 browser_navigate、browser_click）。

  3. 定义带目标的任务

    打开预发布站点，用测试账号登录，导航到设置页，并告诉我新的开关是否可见。

  4. 监督工具调用

    关注每一次工具调用。批准敏感操作（写、删），拒绝任何异常行为。

  5. 根据结果迭代

    如果智能体误读了页面，指引它使用正确的选择器，或先让它导出 DOM。

关键提示词

使用 playwright MCP 服务器，打开 [URL]，执行登录流程，然后检查设置页中是否存在”导出数据”按钮。每一步都报告你看到的内容。

常见坑点

  • 服务器权限过大：只授予任务所需的最少工具；不用时移除破坏性工具。
  • 不稳定的选择器：标记变化时 UI 自动化会失效——要求智能体在每个操作后验证状态。
  • 冗长的工具链：一次只要求一个逻辑步骤，以保持对多工具工作流的掌控。

相关文档

  • MCP 服务器 — 如何配置和使用 Model Context Protocol 服务器
  • 工具 — 智能体可调用的内置与自定义工具

相关案例

相关文档

下一步