内容
<div align="center">
**用于开放代码的MCP服务器 - 通过持久的开放代码服务器查询 GitHub-Copilot 模型。**
<a href="https://kud.io/projects/mcp-opencode">官方网站</a> · <a href="https://kud.io/projects/mcp-opencode/docs">文档</a>
</div>
## 功能特点
- **无需 API 密钥** - 通过本地运行的开放代码服务器路由提示，因此在您的 AI 客户端中不需要提供商凭证。
- **多模型支持** - 开放代码中配置的任何模型都可用；查询 GPT-4.1、Claude、Gemini 或任何其他支持的提供商。
- **模型过滤** - 通过 `MCP_OPENCODE_MODEL_ALLOW` 和 `MCP_OPENCODE_MODEL_BLOCK` 环境变量使用 glob 样式模式限制或阻止模型。
- **自动启动** - 如果开放代码尚未在端口 4096 上监听，服务器会自动在后台启动它。
- **会话隔离** - 每个 `query` 调用都创建并销毁一个专用的开放代码会话，防止调用之间状态泄漏。
- **无处不在** - 与 Claude Desktop、Claude Code、Cursor、Windsurf、VSCode 和任何支持 MCP 的客户端兼容。
## 安装
```sh
npm install -g @kud/mcp-opencode
```
需要安装 [opencode](https://opencode.ai) 并配置至少一个提供商，且 Node.js ≥ 20。
## 使用
将服务器添加到您的 MCP 客户端配置中：
```json
{
"mcpServers": {
"opencode": {
"command": "npx",
"args": ["-y", "@kud/mcp-opencode"]
}
}
}
```
要限制可用的模型，请传递环境变量：
```json
{
"mcpServers": {
"opencode": {
"command": "npx",
"args": ["-y", "@kud/mcp-opencode"],
"env": {
"MCP_OPENCODE_MODEL_ALLOW": "github-copilot/*",
"MCP_OPENCODE_MODEL_BLOCK": "github-copilot/gpt-4o-mini"
}
}
}
}
```
### 可用工具
| 工具 | 描述 |
| ------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `query` | 向开放代码模型发送提示。接受 `prompt`（必需）和 `model`（可选，默认为 `github-copilot/gpt-4.1`）。 |
| `list_models` | 列出通过正在运行的开放代码服务器可用的模型。接受可选的 `provider` 过滤器（例如 `anthropic`）。 |
## 开发
```sh
git clone https://github.com/kud/mcp-opencode.git
cd mcp-opencode
npm install
npm run build
npm test
```
使用本地 `.mcp.json` 将 Claude Code 连接到您的开发版本，或使用 `npm run inspect` 在编译后的输出上打开 MCP Inspector。
| 脚本 | 目的 |
| ----------------- | ------------------------------------------- |
| `npm run dev` | 通过 `tsx` 从源代码运行 |
| `npm run build` | 将 TypeScript 编译到 `dist/` |
| `npm test` | 运行 Vitest 测试套件 |
| `npm run inspect` | 在构建的服务器上打开 MCP Inspector |
📚 **完整文档 → [mcp-opencode/docs](https://kud.io/projects/mcp-opencode/docs)**
