OpenCode MCP 工具

<div align="center">

</div>

📚 文档在 docs 文件夹中 - 示例、常见问题解答、故障排除、最佳实践

这是一个模型上下文协议（MCP）服务器，允许AI助手通过OpenCode CLI进行交互。它使AI助手能够通过统一接口利用多个AI模型，具有计划模式等功能，用于结构化思考和广泛的模型选择。

• 通过Claude或其他MCP客户端使用多个AI模型提问
• 使用计划模式进行结构化分析和更安全的操作

TLDR: + 通过OpenCode的多个AI模型

目标：在Claude Code中直接使用OpenCode的多模型能力，具有灵活的模型选择和计划模式功能。

先决条件

在使用此工具之前，请确保您已具备以下条件：

1. Node.js (v16.0.0或更高版本)
2. 安装并配置了**OpenCode CLI**

一键设置

claude mcp add opencode -- npx -y opencode-mcp-tool -- --model google/gemini-2.5-pro

验证安装

在Claude Code中键入 /mcp 来验证opencode-cli MCP是否处于活动状态。

---

替代方案：从Claude Desktop导入

如果您已经在Claude Desktop中进行了配置：

1. 在您的Claude Desktop配置中添加：

"opencode": {
  "command": "npx",
  "args": ["-y", "opencode-mcp-tool", "--", "--model", "google/gemini-2.5-pro"]
}

2. 导入到Claude Code：

claude mcp add-from-claude-desktop

配置

注册您的MCP客户端的MCP服务器。注意：服务器需要指定一个主模型。

用于NPX使用（推荐）

将此配置添加到您的Claude Desktop配置文件中：

{
  "mcpServers": {
    "opencode": {
      "command": "npx",
      "args": ["-y", "opencode-mcp-tool", "--", "--model", "google/gemini-2.5-pro", "--fallback-model", "google/gemini-2.5-flash"]
    }
  }
}

全局安装

如果您是全局安装的，请使用以下配置：

{
  "mcpServers": {
    "opencode": {
      "command": "opencode-mcp",
      "args": ["--model", "google/gemini-2.5-pro", "--fallback-model", "google/gemini-2.5-flash"]
    }
  }
}

配置文件位置：

• Claude Desktop：
  • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows：%APPDATA%\Claude\claude_desktop_config.json
  • Linux：~/.config/claude/claude_desktop_config.json

更新配置后，请重新启动您的终端会话。

示例工作流程

• 自然语言："使用opencode解释index.html"，"用opencode理解大型项目"，"让opencode搜索最新新闻"
• Claude Code：键入 /opencode 并在Claude Code界面中填充命令。

使用示例

带有文件引用（使用@语法）

• 让opencode分析@src/main.js并解释其作用
• 使用opencode总结@. 当前目录
• 分析@package.json并告诉我关于依赖项的信息

普通问题（无文件）

• 让opencode搜索最新的科技新闻
• 使用opencode解释div居中
• 询问opencode关于与@file_im_confused_about相关的React开发最佳实践

使用OpenCode的计划模式

计划模式允许您安全地测试代码更改、运行脚本或执行潜在风险操作，同时进行结构化规划。

• 使用opencode计划模式创建并运行处理数据的Python脚本
• 让opencode安全地测试@script.py并解释其作用
• 使用opencode计划模式安装numpy并创建数据可视化
• 安全地测试这段代码：创建一个向API发送HTTP请求的脚本

工具（供AI使用）

这些工具旨在由AI助手使用。

• ask-opencode：使用模型选择和模式控制执行OpenCode。默认情况下使用计划模式进行结构化分析。
  • prompt（必需）：分析请求。使用@语法包括文件或目录引用（例如，@src/main.js 解释这段代码），或提出一般性问题（例如，请使用网络搜索找到最新的新闻故事）。
  • model（可选）：要使用的模型。如果没有指定，则使用服务器启动时配置的主要模型。
  • mode（可选）：执行模式 - 'plan'（默认）用于结构化分析，'build'用于即时执行，或自定义模式字符串。
• brainstorm：使用创意框架（如SCAMPER、设计思维等）动态收集上下文，生成新颖的想法，结合领域上下文，进行想法聚类、可行性分析和迭代改进。
  • prompt（必需）：主要头脑风暴挑战或探索的问题。
  • methodology（可选）：头脑风暴框架 - 'divergent'、'convergent'、'scamper'、'design-thinking'、'lateral' 或 'auto'（默认）。
  • domain（可选）：领域上下文（例如，'软件'、'商业'、'创意'、'研究'）。
  • ideaCount（可选）：要生成的目标想法数量（默认：1_2）。
  • includeAnalysis（可选）：包括可行性及影响分析（默认：true）。
• timeout-test：通过运行指定持续时间来测试超时预防。
  • duration（必需）：测试的持续时间（以毫秒为单位）。
• ping：返回消息的回声测试工具。
  • prompt（可选）：要回显的消息。
• Help：显示OpenCode CLI的帮助文本。

斜杠命令（供用户使用）

您可以在Claude Code界面中直接使用这些命令（尚未测试与其他客户端的兼容性）。

• /plan：在计划模式下执行OpenCode，进行结构化分析和更安全的操作。
  • prompt（必需）：分析请求（例如，/plan prompt:创建并运行处理CSV数据的Python脚本 或 /plan prompt:@script.py 安全地分析这个脚本）。
• /build：在即时执行模式下执行OpenCode，直接实现。
  • prompt（必需）：即时代码执行的实现请求。
• /help：显示OpenCode CLI的帮助信息。
• /ping：测试与服务器的连接。
  • prompt（可选）：要回显的消息。

贡献

欢迎贡献！请参阅我们的贡献指南，了解如何提交拉取请求、报告问题以及参与项目。

许可证

本项目采用MIT许可证。详情请参阅LICENSE文件。

免责声明：这是一个非官方的第三方工具，并未得到Google的认可、赞助或支持。