Unicoda MCP

MCP开发工具

提供方 hongw · 包名 @hongw/unicoda-mcp

开发工具 stdio · 本地进程 会话登录 社区 / 第三方 Claude
查看接入方式

提供统一接口封装多种AI编码代理SDK,实现工作区管理、会话和聊天的标准化交互。

一句话选型结论

按资料字段整理

Unicoda MCP 属于开发工具类 MCP 服务器,stdio · 本地进程,会话登录,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权会话登录 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 12 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量12暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

AI编码代理TypeScript本地部署SDK抽象层工作区管理会话管理开发者工具

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
npx @hongw/unicoda-mcp

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 12 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 12 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Unicoda MCP当前 12 stdio · 本地进程 本地部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方hongw上游标注的维护方 hongw
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时@hongw/unicoda-mcp · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.8 KB
来自项目仓库与上游目录的原文,未做删改

Unicoda MCP服务器

统一的AI编码代理MCP服务器——将多个编码代理SDK封装在一致的 模型上下文协议(MCP) 界面。

概述

Unicoda允许MCP客户端通过一个标准化的抽象层与不同的AI编码代理进行交互。您无需单独集成每个SDK,而是可以获得一个用于工作区管理、会话和聊天的一致接口。

核心概念

概念 描述
提供者 后端SDK(副产品、codex、claude代码)
工作区 绑定到项目目录的代理实例。读取指令文件,如 AGENTS.md 为了上下文。
会话 工作空间内的对话。支持带上下文的多回合对话。
请求 单个消息发送,由以下人员跟踪 requestId.

建筑```

┌─────────────────┐
│ MCP Client │
└────────┬────────┘
│ MCP Protocol
▼
┌─────────────────────────────────────────┐
│ Unicoda MCP Server │
│ ┌─────────────────────────────────┐ │
│ │ Unified Tool Interface │ │
│ └─────────────┬───────────────────┘ │
│ ┌─────────────┴───────────────────┐ │
│ │ Provider Abstraction │ │
│ │ ┌─────────┐ ┌───────┐ ┌─────┐ │ │
│ │ │ Copilot │ │ Codex │ │ ... │ │ │
│ │ └─────────┘ └───────┘ └─────┘ │ │
│ └─────────────────────────────────┘ │
└─────────────────────────────────────────┘


## 支持的提供商

|提供者|SDK|状态|
|----------|-----|--------|
| **GitHub Copilot** | `@github/copilot-sdk` | ✅ 已执行|
| **OpenAI 代码专家** | `@openai/codex-sdk` | 🔜 计划中|
| **克劳德代码** |TBD |🔜 计划中|

## 安装```bash
# Run directly from npm
npx @hongw/unicoda-mcp

# Or install globally
npm install -g @hongw/unicoda-mcp

# Or clone and build from source
git clone https://github.com/hongw/unicoda-mcp
cd unicoda-mcp
pnpm install
pnpm build
node dist/index.js

MCP配置

添加到MCP客户端配置中:```json
{
"mcpServers": {
"unicoda": {
"command": "node",
"args": ["/path/to/unicoda-mcp/dist/index.js"],
"env": {
"UNICODA_PROVIDER": "copilot"
}
}
}
}


## 配置选项

|参数|环境变量|默认值|说明|
|-----------|---------------------|---------|-------------|
| `--provider` | `UNICODA_PROVIDER` | `copilot` |默认提供程序|
| `--auto-start-workspace` | `UNICODA_AUTO_START_WORKSPACE` | `true` |需要时自动启动工作区|
| `--max-workspaces` | `UNICODA_MAX_WORKSPACES` | `10` |最大并发工作空间|
| `--workspace-ttl` | `UNICODA_WORKSPACE_TTL` | `1800000` |工作区空闲超时(ms)|
| `--port-range-start` | `UNICODA_PORT_RANGE_START` | `40000` |CLI端口分配开始|

## 可用工具

### 工作空间管理

|工具|说明|
|------|-------------|
| `workspace_start` |为项目目录启动工作区|
| `workspace_stop` |停止工作区|
| `workspace_list` |列出所有正在运行的工作区|

### 会话管理

|工具|说明|
|------|-------------|
| `session_create` |创建新的对话会话|
| `session_list` |列出工作区中的会话|
| `session_delete` |删除会话|
| `session_history` |获取完整的聊天记录|

### 聊天

|工具|说明|
|------|-------------|
| `send` |发送消息(立即返回 `requestId`) |
| `send_and_wait` |发送消息并等待完成|
| `poll` |使用可选的长轮询检查请求状态|
| `abort` |中止正在进行的请求|

### 效用

|工具|说明|
|------|-------------|
| `models_list` |列出可用型号|

## 快速开始```javascript
// 1. Create session (auto-starts workspace)
session_create({ workspace: "/path/to/project" })
// → { sessionId: "sess-xyz", workspaceId: "ws-abc", autoStarted: true }

// 2. Send task and wait for completion
send_and_wait({
workspace: "ws-abc",
sessionId: "sess-xyz",
prompt: "Add error handling to src/api.ts"
})
// → { requestId: "req-123", status: "completed", messages: [...] }

投票选项

这 poll 该工具支持长轮询和响应过滤:

参数 说明
timeout 轮询超时时间过长(毫秒)。等待此时间完成。
detail 响应详细级别:
status --只有 requestId 和 status
message --状态+助理短信
brief --状态+消息+工具调用摘要(截断)
full --全部(默认)

消息格式

答复包括a messages 包含对话事件的数组:```typescript
interface Message {
type: 'user' | 'assistant' | 'tool_call' | 'tool_result' | 'system' | 'error';
content: string;
timestamp: string; // ISO8601
metadata?: {
toolName?: string;
toolArgs?: unknown;
toolResult?: unknown;
// ...
};
}


## 请求状态

所有请求都遵循统一的状态机:```
queued → running → completed
→ error
→ timeout
↓
aborted

错误处理

错误包括结构化信息:```json
{
"error": {
"code": "WORKSPACE_NOT_FOUND",
"message": "Workspace ws-xyz not found",
"retryable": false
}
}


常见错误代码: `WORKSPACE_NOT_FOUND`, `SESSION_NOT_FOUND`, `REQUEST_NOT_FOUND`, `TIMEOUT`, `CLI_START_FAILED`

## 发展```bash
pnpm install
pnpm build
pnpm test
pnpm lint

贡献

欢迎投稿!看 建筑.md 了解内部设计细节和实施说明。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Unicoda MCP 怎么安装?

在客户端按下面的安装命令接入:npx @hongw/unicoda-mcp。对应的包名是 @hongw/unicoda-mcp。装完在客户端配置里引用同一个包或端点。

Unicoda MCP 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Unicoda MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Unicoda MCP 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Unicoda MCP 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Unicoda MCP 能提供哪些能力?

资料显示约 12 个工具;能力标签包括 工作区管理、TypeScript、Claude、会话管理。具体工具清单以官方文档为准。

Unicoda MCP 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Unicoda MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。