你可能已经发现了,OpenCode 这东西启动快、界面干净、功能简洁。但用久了总觉得差点意思,好像少了点什么。
没错,差的就是插件。
OpenCode 的设计理念很有意思:刻意保持极简,把核心能力做薄,然后把扩展性留给插件生态。这就像苹果手机自带的应用足够用,但真正强大的功能都在 App Store 里。
真正的力量,不在 OpenCode 本身,而在插件、MCP 服务器和 LSP 工具里。
这篇文章,我帮你精选了最值得安装的插件和 MCP 服务器。不整虚的,都是能直接提升你开发效率的真东西。
插件系统简介:OpenCode 的隐藏宝藏
在聊具体插件之前,先说说 OpenCode 的插件系统是怎么回事。这部分了解一下就行,重点在后面。
插件是什么
OpenCode 插件本质上是 npm 包,提供了扩展 OpenCode 能力的方法。它们可以:
集成额外的 LSP 服务器 添加 MCP 服务器 定义自定义 Hooks 提供命令和工具
换句话说,插件是 OpenCode 的“四肢”,没有插件,OpenCode 只是个光杆司令。
安装方式
OpenCode 插件有两种安装方式:
1. 全局安装
npm install -g @your/plugin-name
全局安装后,所有项目都能使用。
2. 项目安装
在项目根目录安装:
npm install --save-dev @your/plugin-name
然后在 opencode.json中配置。
加载顺序
OpenCode 插件按以下顺序加载:
内置插件(不可禁用) 全局插件( ~/.opencode/plugins/目录)项目级插件(当前项目的 node_modules/)
这意味着项目级配置可以覆盖全局配置,灵活度很高。
配置文件位置
插件配置在 opencode.json文件中:
{
"plugins": [
"@your/plugin-name"
],
"mcpServers": {
"server-name": {
"command": "npx",
"args": ["-y", "@your/mcp-server"]
}
}
}
配置文件支持插件、MCP 服务器、LSP 服务器等多种配置。
推荐安装的插件
接下来是重点部分。我把插件分成几类:编排层插件、增强工作流插件、工具类插件。
Oh My OpenCode:编排层的集大成者
如果你只安装一个插件,那必须是 Oh My OpenCode。
这个插件是 OpenCode 插件生态里的“瑞士军刀”,它不是一个功能,而是一套完整的能力整合。
核心功能:
整合 LSP、MCP、Hooks 到一个统一框架 内置 Context7 和 grep.app 配置,开箱即用 20+ 个上下文管理钩子,自动帮你处理上下文 Planner-Sisyphus 任务规划代理,帮助拆解复杂任务
简单来说,Oh My OpenCode 就像一个“插件管理器”,它把其他插件的能力整合在一起,让你不用一个个配置。
安装方式:
npm install -g oh-my-opencode
然后在 opencode.json中启用:
{
"plugins": ["oh-my-opencode"]
}
配置完成后,Oh My OpenCode 会自动帮你加载内置的 MCP 服务器和 Hooks。
适用场景:
不想一个个配置插件的人 需要任务规划能力的人 想用 Context7 但不想手动配置的人
oc-blackbytes:工作流增强神器
第二个推荐的是 oc-blackbytes,来自社区贡献者 cuongntr。
这个插件主打“增强工作流”,内置了一堆实用的 MCP 服务器和代理。
核心功能:
内置 MCP:websearch、context7、grep_app 内置代理:bytes(字节码分析)、explore(探索代码)、oracle(知识问答)、reviewer(代码审查) 命令支持:提供 /setup-models和/review命令动态调整:支持模型参数的动态调整
这个插件特别适合需要频繁搜索信息、做代码审查的人。
安装方式:
npm install -g oc-blackbytes
配置示例:
{
"plugins": ["oc-blackbytes"],
"mcpServers": {
"websearch": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-websearch"]
}
}
}
使用技巧:
/setup-models:快速配置多个模型/review:对当前代码进行审查直接使用内置的 MCP,比如问“帮我搜索最新的 React 文档”
opencode-toolbox:工具搜索专家
第三个推荐 opencode-toolbox,解决了一个很实际的问题:MCP 工具太多,token 消耗不起。
随着你安装的 MCP 服务器越来越多,OpenCode 会加载所有工具。但实际上,你可能只需要其中几个。这就像请了一堆顾问,但大部分时间都在旁边站着,还照常领工资。
opencode-toolbox 解决了这个痛点。
核心功能:
BM25 搜索:基于文本相关性的搜索算法,快速找到需要的工具 正则搜索:支持正则表达式匹配 按需加载:只加载你正在使用的工具,减少 token 消耗
简单来说,这个插件让你的 MCP 工具“按需加载”,而不是全部加载。
安装方式:
npm install -g opencode-toolbox
配置:
{
"plugins": ["opencode-toolbox"]
}
使用方式:在对话中输入工具名称,它会自动搜索并加载。
适用场景:
安装了很多 MCP 服务器的人 关心 token 消耗的人 需要快速找到特定工具的人
opencode-lazy-loader:懒加载 MCP
第四个推荐 opencode-lazy-loader,和 toolbox 有点类似,但更激进。
它的核心理念是:MCP 服务器不应该一直开着,应该像云函数一样,按需启动,不用时自动关闭。
核心功能:
技能嵌入:把 MCP 服务器封装成“技能” 按需启动:只有调用时才启动 自动关闭:5分钟空闲自动关闭 团队共享:支持团队统一配置
这个插件特别适合团队使用,可以让整个团队的 MCP 配置统一管理。
安装方式:
npm install -g opencode-lazy-loader
配置示例:
{
"plugins": ["opencode-lazy-loader"],
"lazyMcp": {
"sentry": {
"package": "@modelcontextprotocol/server-sentry",
"idleTimeout": 300000
},
"context7": {
"package": "@context7/mcp-server",
"idleTimeout": 300000
}
}
}
工作原理:
当你第一次调用某个 MCP 时,它会启动服务器;如果你 5 分钟没有使用,它会自动关闭。这样既保证了功能,又节省了资源。
MCP 服务器推荐
除了插件,MCP 服务器也是 OpenCode 生态的重要部分。以下是几个最值得安装的 MCP 服务器。
Sentry:错误监控集成
如果你做 Web 开发,Sentry 几乎是必备的。OpenCode 通过 MCP 服务器集成了 Sentry。
功能:
查询项目中的错误 查看错误详情(堆栈、上下文) 创建 Issue
安装方式:
npm install -y @modelcontextprotocol/server-sentry
配置:
{
"mcpServers": {
"sentry": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sentry"],
"env": {
"SENTRY_AUTH_TOKEN": "your-token",
"SENTRY_ORG": "your-org"
}
}
}
}
使用场景:
“帮我看看最近有什么新的错误” “查看这个错误的详细信息” “帮我创建一个 Issue”
Context7:文档搜索利器
Context7 是我最喜欢的 MCP 服务器之一。它能搜索各种库的官方文档,而且会返回最新的内容。
功能:
搜索官方文档 获取代码示例 理解 API 用法
安装方式:
npm install -y @context7/mcp-server
配置:
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@context7/mcp-server"]
}
}
}
使用方式:
在提示词中添加 use context7,比如:
帮我看看 React useEffect 的用法,use context7
Context7 会自动搜索相关文档,并返回代码示例。
适用场景:
查文档、API 用法 学习新库 确认某个函数的参数
Grep by Vercel:GitHub 代码搜索
最后一个推荐 Grep by Vercel,来自 Vercel 官方。
这个 MCP 服务器可以搜索 GitHub 上的代码片段,相当于一个“GitHub 版 grep”。
功能:
搜索 GitHub 代码仓库 查找代码示例 理解实际用法
安装方式:
npm install -y @vercel/mcp-github-grep
配置需要 GitHub Token:
{
"mcpServers": {
"gh_grep": {
"command": "npx",
"args": ["-y", "@vercel/mcp-github-grep"],
"env": {
"GITHUB_TOKEN": "your-token"
}
}
}
}
使用方式:
帮我搜索 React 中 useState 的用法,use gh_grep tool
它会返回 GitHub 上真实的代码示例,比文档更接地气。
安装指南:手把手教学
说了这么多,怎么安装呢?这部分给你完整的步骤。
全局安装 vs 项目安装
全局安装:
适合所有人、所有项目都能用的插件:
npm install -g @your/plugin-name
然后在 ~/.opencode/opencode.json中配置。
项目安装:
只给当前项目用的插件:
cd your-project
npm install --save-dev @your/plugin-name
然后在项目根目录的 opencode.json中配置。
配置文件示例
创建或编辑 opencode.json:
{
"plugins": [
"oh-my-opencode",
"oc-blackbytes",
"opencode-toolbox"
],
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@context7/mcp-server"]
},
"sentry": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sentry"],
"env": {
"SENTRY_AUTH_TOKEN": "your-token",
"SENTRY_ORG": "your-org"
}
},
"gh_grep": {
"command": "npx",
"args": ["-y", "@vercel/mcp-github-grep"],
"env": {
"GITHUB_TOKEN": "your-token"
}
}
}
}
使用 package.json 管理依赖
你也可以把插件放到 package.json中:
{
"devDependencies": {
"oh-my-opencode": "^1.0.0",
"oc-blackbytes": "^1.0.0",
"opencode-toolbox": "^1.0.0"
}
}
然后运行 npm install安装。
避坑指南:这些坑不要踩
插件虽好,但不要贪多。以下是几个常见的坑:
坑1:一次性装太多 MCP
很多人觉得 MCP 服务器越多越好,实际上恰恰相反。
MCP 服务器会占用资源,而且每个工具都会消耗 token。装 10 个 MCP 不代表效率提升 10 倍,反而可能导致:
启动变慢 token 消耗加剧 工具选择困难
建议:先装 2-3 个常用的,等熟悉了再逐步添加。
坑2:不注意 token 消耗
OpenCode 会把 MCP 服务器的工具都加载进来,这意味着即使你不用,某些工具也会消耗 token。
建议:使用 opencode-toolbox 或 opencode-lazy-loader,按需加载工具。
坑3:版本不锁定
有些插件更新很频繁,如果不锁定版本,可能导致启动失败或功能异常。
建议:在 package.json 中锁定版本:
{
"devDependencies": {
"oh-my-opencode": "1.2.3"
}
}
坑4:忽略配置错误
插件配置有误时,OpenCode 可能不会报错,但插件不生效。
建议:安装后测试一下,确保插件正常工作。
总结:让 OpenCode 更强大
这篇文章给你介绍了 OpenCode 插件系统的基本概念,以及最值得安装的几个插件和 MCP 服务器。
简单回顾一下:
Oh My OpenCode:编排层插件,整合各种能力 oc-blackbytes:增强工作流,内置多个实用工具 opencode-toolbox:工具搜索,按需加载 opencode-lazy-loader:懒加载 MCP,节省资源 Sentry:错误监控集成 Context7:文档搜索 Grep by Vercel:GitHub 代码搜索
插件是 OpenCode 生态的核心。不要被它的极简界面骗了,装上合适的插件,OpenCode 的能力可以翻好几倍。
从你常用的 2-3 个插件开始,慢慢探索,找到最适合你的组合。
参考来源
OpenCode 官方文档:https://open-code.ai/en/docs/ OpenCode MCP 服务器:https://open-code.ai/en/docs/mcp-servers OpenCode 插件:https://open-code.ai/en/docs/plugins Oh My OpenCode:https://ohmyopencode.com/best-opencode-plugins/ oc-blackbytes:https://github.com/cuongntr/oc-blackbytes opencode-toolbox:https://github.com/assagman/opencode-toolbox opencode-lazy-loader:https://github.com/keybrdist/opencode-lazy-loader
夜雨聆风