OpenCode MCP Tool

OpenCode MCP工具

文件可在 docs/ –示例、常见问题解答、故障排除、最佳实践

这是一个模型上下文协议（MCP）服务器，允许AI助手与 OpenCode命令行界面它使AI助手能够通过统一的界面利用多个AI模型，具有结构化思维的计划模式和广泛的模型选择等功能。

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

太长，读不下去了

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

先决条件

在使用此工具之前，请确保您已：

1. **** （v16.0.0或更高版本）
2. OpenCode命令行界面 已安装并配置

单线设置（克劳德代码）

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

Codex CLI设置

如果您使用OpenAI Codex CLI作为MCP客户端，请添加以下服务器：

codex mcp add opencode -- npx -y @gilby125/opencode-mcp-tool -- --model google/gemini-2.5-pro --fallback-model google/gemini-2.5-flash

之后，像往常一样启动Codex CLI，您可以通过自然语言与OpenCode对话（例如，“使用OpenCode解释index.html”），并在有帮助时让Codex调用MCP工具。

验证安装

类型 /mcp 在Claude Code内部验证opencode cli MCP是否处于活动状态。

______________________________________________________________________

替代方案：从Claude Desktop导入

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

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

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

1. 导入到克劳德代码：

claude mcp add-from-claude-desktop

配置

在MCP客户端注册MCP服务器。 注意：服务器需要指定主模型。

NPX使用（推荐）

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

{
  "mcpServers": {
    "opencode": {
      "command": "npx",
      "args": ["-y", "@gilby125/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"]
    }
  }
}

Codex CLI配置

要将此服务器与OpenAI Codex CLI一起使用，请将以下内容添加到您的 ~/.codex/config.toml:

[mcp_servers.opencode]
command = "opencode-mcp"
args = ["--model", "google/gemini-2.5-pro", "--fallback-model", "google/gemini-2.5-flash"]
startup_timeout_sec = 20
tool_timeout_sec = 300

更新Codex配置后，重新启动 codex 并使用以下命令进行测试：

/opencode:ping "Hello from OpenCode MCP!"

配置文件位置：

• 克劳德桌面版:

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/claude/claude_desktop_config.json

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

工作流示例

• 自然语言：“使用opencode解释index.html”，“理解使用opencode的大型项目”，“请opencode搜索最新消息”
• 克劳德代码：类型 /opencode 命令将填充到Claude Code的界面中。

使用示例

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

• ask opencode to analyze @src/main.js and explain what it does
• use opencode to summarize @. the current directory
• analyze @package.json and tell me about dependencies

一般问题（无文件）

• ask opencode to search for the latest tech news
• use opencode to explain div centering
• ask opencode about best practices for React development related to @file_im_confused_about

使用OpenCode的计划模式

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

• use opencode plan mode to create and run a Python script that processes data
• ask opencode to safely test @script.py and explain what it does
• use opencode plan mode to install numpy and create a data visualization
• test this code safely: Create a script that makes HTTP requests to an API

工具（用于AI）

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

• ask-opencode：使用模型选择和模式控制执行OpenCode。默认情况下，使用计划模式进行结构化分析。

- prompt （必填）：分析请求。使用 @ 语法以包括文件或目录引用（例如。， @src/main.js explain this code)或提出一般性问题（例如。， Please use a web search to find the latest news stories). - model （可选）：要使用的模型。如果未指定，则使用服务器启动时配置的主模型。 - mode （可选）：执行模式-“计划”用于结构化分析（默认），“构建”用于立即执行，或自定义模式字符串。

• brainstorm：使用创造性框架（SCAMPER、设计思维等）、领域背景集成、想法聚类、可行性分析和迭代细化，通过动态背景收集产生新想法。

- prompt （必填）：初步头脑风暴挑战或问题探索。 - methodology （可选）：头脑风暴框架-“发散”、“收敛”、“骗子”、“设计思维”、“横向”或“自动”（默认）。 - domain （可选）：领域上下文（例如，“软件”、“商业”、“创意”、“研究”）。 - ideaCount （可选）：要生成的目标想法数（默认值：12）。 - includeAnalysis （可选）：包括可行性和影响分析（默认值：true）。

• timeout-test：通过运行指定的持续时间来测试超时预防。

- duration （必填）：测试的持续时间（毫秒）。

• ping：返回消息的回声测试工具。

- prompt （可选）：要回显的消息。

• Help：显示OpenCode CLI帮助文本。

Slash命令（用户）

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

• /计划：在计划模式下执行OpenCode，以进行结构化分析和更安全的操作。

- prompt （必填）：分析请求（例如。， /plan prompt:Create and run a Python script that processes CSV data 或 /plan prompt:@script.py Analyze this script safely).

• /建造：以立即执行模式执行OpenCode以直接实现。

- prompt （必填）：立即执行代码的实现请求。

• /帮助：显示OpenCode CLI帮助信息。
• /ping：测试与服务器的连接。

- prompt （可选）：要回显的消息。

贡献

欢迎投稿！请查看我们的 贡献指南 有关如何提交pull请求、报告问题和为项目做出贡献的详细信息。

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。

免责声明： 这是一个非官方的第三方工具，不隶属于谷歌，也不受谷歌的认可或赞助。