Unicoda MCP

Unicoda MCP服务器

 

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

概述

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

核心概念

建筑

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

支持的提供商

安装

# 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客户端配置中：

{
  "mcpServers": {
    "unicoda": {
      "command": "node",
      "args": ["/path/to/unicoda-mcp/dist/index.js"],
      "env": {
        "UNICODA_PROVIDER": "copilot"
      }
    }
  }
}

配置选项

可用工具

工作空间管理

会话管理

聊天

效用

快速开始

// 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 该工具支持长轮询和响应过滤：

消息格式

答复包括a messages 包含对话事件的数组：

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

错误处理

错误包括结构化信息：

{
  "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

发展

pnpm install
pnpm build
pnpm test
pnpm lint

贡献

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