Conductor By Thealxlabs

Conductor

一个 MCP 服务。100 多种工具。适用于所有 AI Agent。

Conductor 是一个独立的模型上下文协议服务，让任何 AI Agent——Claude、Cursor、Cline、Copilot 等——都能通过一个连接即时访问你的整个工具集。安装一次，配置一次，随处使用。

npm install -g @useconductor/conductor
conductor init

---

为什么选择 Conductor

大多数 MCP 配置都意味着每种工具各配一个服务——GitHub 一个、Slack 一个、数据库一个。这样就需要运行十几个进程、编写十几份配置，还要操心十几处可能出问题的地方。

Conductor 将这一切整合到一个服务中，内置插件系统，从一开始就具备安全防护，并提供真正好用的命令行工具。

• 100 多种工具，涵盖 35 多个插件，全部运行在一个进程中
• 零配置插件即装即用——无需 API 密钥，无需设置
• 机密信息保存在操作系统钥匙串中——绝不存储在配置文件里
• 每次工具调用都具备熔断和重试机制——故障不会扩散
• SHA-256 链式审计日志——记录每项操作，并能检测篡改
• 在 AI 客户端中只需配置一个配置块——集成就是这么简单

---

快速开始

# Install
npm install -g @useconductor/conductor

# First-run wizard — AI provider, plugins, client config
conductor init

Claude Desktop

将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "conductor": {
      "command": "conductor",
      "args": ["mcp", "start"]
    }
  }
}

也可以跳过手动编辑：conductor mcp setup

Cursor / Windsurf / Cline / Continue

配置块相同——将其放入 .cursor/mcp.json、.codeium/windsurf/mcp_config.json 或客户端的 MCP 配置文件中。

无需全局安装

{
  "mcpServers": {
    "conductor": {
      "command": "npx",
      "args": ["-y", "@useconductor/conductor", "mcp", "start"]
    }
  }
}

---

插件

需要设置

插件	功能	设置方式
github	仓库、问题、PR、代码搜索（20 种工具）	GITHUB_TOKEN 环境变量
gmail	读取、撰写、发送、搜索和标记邮件	conductor google
gcal	活动、空闲时间、日程安排	conductor google
gdrive	搜索、读取和上传文件	conductor google
notion	页面、数据库、内容块、搜索	API 密钥
slack	消息、频道、搜索	conductor slack setup
linear	问题、项目、周期	API 密钥
jira	问题、项目、冲刺	域名 + API 令牌
stripe	付款、客户、发票	密钥
docker	容器、镜像、卷、网络	本地 Docker 套接字
database	Postgres、MySQL 查询	连接 URL
github-actions	触发并监控 CI 工作流	GITHUB_TOKEN
vercel	部署、日志、项目	API 令牌
n8n	触发工作流、列出执行记录	基础 URL + API 密钥
spotify	播放、搜索、播放列表	客户端 ID + 密钥
x	发布、搜索、时间线	API 凭据
homekit	通过 Homebridge 控制灯、门锁、恒温器	基础 URL
lumen	智能照明控制	本地设置
todoist	任务、项目、标签	API 令牌
shell	运行允许列表中的 Shell 命令	默认启用

零配置（即刻可用）

插件	功能
calculator	数学表达式、单位换算、日期运算
colors	转换 hex/RGB/HSL、生成调色板、WCAG 对比度
crypto	加密、解密、签名、验证
hash	SHA-256/MD5/SHA-512、base64、UUID、密码
text-tools	JSON 格式化、字数统计、正则表达式测试、大小写转换
timezone	任意城市的当前时间、时区转换
url-tools	展开短链接、检查状态、查看标头
network	Ping、DNS 查询、端口检查、IP 信息
system	CPU、内存、磁盘使用情况
weather	按城市查询当前天气和预报
translate	在不同语言之间翻译文本
fun	笑话、趣闻、名言
notes	本地 Markdown 笔记
memory	跨会话持久化键值记忆
cron	安排重复任务

---

CLI 参考

设置

conductor init                        # First-run wizard
conductor mcp setup                   # Auto-configure Claude Desktop / Cursor
conductor mcp start                   # Start MCP server (stdio)
conductor mcp status                  # Show MCP server status
conductor doctor                      # Diagnose common issues
conductor health                      # System health report
conductor health --json               # Machine-readable health output

插件

conductor plugins list                # List all plugins (enabled/disabled)
conductor plugins enable <name>       # Enable a plugin
conductor plugins disable <name>      # Disable a plugin
conductor onboard                     # Interactive TUI plugin picker
conductor install <plugin>            # Install from marketplace
conductor marketplace                 # Browse marketplace
conductor marketplace info <plugin>   # Plugin details
conductor plugin create <name>        # Scaffold a new plugin with tests

身份验证

conductor google                      # Browser-based Google OAuth (Gmail, Calendar, Drive)
conductor slack setup                 # Configure Slack bot + app tokens
conductor slack start                 # Start the Slack bot
conductor telegram setup              # Configure Telegram bot token
conductor telegram start              # Start the Telegram bot
conductor ai setup                    # Configure AI provider
conductor ai test                     # Test current AI provider

配置

conductor config list                 # Show all config keys and values
conductor config get <key>            # Get a specific key (e.g. ai.provider)
conductor config set <key> <value>    # Set a key (JSON or string)
conductor config path                 # Print config file path
conductor config export               # Dump config as JSON
conductor config validate             # Check config structure
conductor config reset                # Reset to defaults

审计日志

conductor audit list                  # List recent entries
conductor audit list --actor user1    # Filter by actor
conductor audit list --result failure # Filter by result
conductor audit verify                # Verify SHA-256 chain integrity
conductor audit tail                  # Stream in real time
conductor audit stats                 # Summary statistics
conductor audit export -o out.json    # Export to file
conductor audit rotate                # Manually rotate log file

熔断器

conductor circuit list                # Show state of all circuit breakers
conductor circuit reset <tool>        # Reset a specific circuit to closed

自主模式及其他

conductor proactive start             # Start autonomous reasoning loop
conductor dashboard                   # Open web dashboard (--port <n>)
conductor release                     # Bump version and publish to npm

---

安全模型

每次工具调用都会经过一系列检查，然后才到达处理程序：

Request
  → Zod input validation        (schema-level type safety)
  → RBAC permission check        (role-based access control)
  → Circuit breaker              (opens after 5 failures, recovers in 30s)
  → Retry with exponential backoff
  → Handler
  → Audit log entry              (SHA-256 chained, append-only)
  → Metrics

密钥通过 @useconductor/conductor 的钥匙串模块存储在操作系统钥匙串中（macOS Keychain、Linux Secret Service、Windows Credential Manager），绝不会存储在 config.json 中。

Shell 命令必须通过严格的允许列表检查。不使用 eval()，不使用任意输入调用 exec()，也不使用通配符。列表涵盖常见开发工具：git、docker、node、npm、curl、psql 等约 50 种工具。

破坏性工具设置 requiresApproval: true — AI Agent 必须在执行前明确确认。

位于 ~/.conductor/audit/audit.log 的审计日志采用带有 SHA-256 链的 JSONL 格式。每条记录都会对上一条记录的哈希值与自身内容进行哈希运算。可随时使用 conductor audit verify 验证完整性。

所有 HTTP 端点都通过 express-rate-limit 进行速率限制。

---

架构

src/
├── cli/            Commander CLI — commands in src/cli/commands/
│   └── commands/   init, mcp, plugins, audit, config, circuit, auth, ...
├── core/           Conductor orchestrator, config, database, audit, retry, circuit-breaker
├── mcp/            MCP server — stdio + HTTP/SSE transports
├── plugins/        Plugin manager, validation, 35 builtin plugins
│   └── builtin/    calculator, github, slack, gmail, docker, shell, ...
├── ai/             Multi-provider AI (Claude, OpenAI, Gemini, Ollama, OpenRouter)
├── bot/            Telegram + Slack bot runtimes
├── dashboard/      Express web dashboard + REST API
└── security/       Keychain, RBAC, auth

配置存储在 ~/.conductor/：

路径	内容
config.json	非机密设置
conductor.db	SQLite 历史记录和活动日志
audit/audit.log	防篡改审计链（JSONL）
plugins/	外部插件 .js 文件
.key	绑定到本机的 AES-256-GCM 加密密钥

---

编写插件

安装 SDK 以获取类型：

npm install @useconductor/sdk

import type { Plugin, PluginTool } from '@useconductor/sdk';

class MyPlugin implements Plugin {
  name = 'my-plugin';
  description = 'Does something useful';
  version = '1.0.0';

  async initialize(): Promise<void> {}
  isConfigured(): boolean { return true; }

  getTools(): PluginTool[] {
    return [
      {
        name: 'my_tool',
        description: 'Explain what this does in one sentence',
        inputSchema: {
          type: 'object',
          properties: {
            query: { type: 'string', description: 'The query to process' },
          },
          required: ['query'],
        },
        handler: async ({ query }) => {
          return { result: `Processed: ${query}` };
        },
      },
    ];
  }
}

export default new MyPlugin();

编译到 ~/.conductor/plugins/my-plugin.js 后即可立即使用。

使用脚手架并生成测试：

conductor plugin create my-plugin

对于需要密钥的插件，添加包含 secret: true 字段的 configSchema — 系统会自动将这些字段存储在操作系统钥匙串中。

---

以编程方式使用

import { ConductorClient } from '@useconductor/sdk';

// stdio (local)
const client = new ConductorClient({ transport: 'stdio' });
await client.connect();

const tools = await client.listTools();
const result = await client.callText('calc_math', { expression: 'sqrt(144) + 8' });
console.log(result); // "20"

await client.disconnect();

// HTTP/SSE (remote)
const remote = new ConductorClient({
  transport: 'http',
  url: 'http://your-conductor-host:3000',
});

---

支持的客户端

适用于任何兼容 MCP 的客户端：

• Claude Desktop
• Cursor
• Cline（VS Code）
• Windsurf
• Continue.dev
• Zed
• Aider
• Roo Code
• VS Code（GitHub Copilot）
• 支持 MCP stdio 传输的任何客户端

---

参与贡献

git clone https://github.com/useconductor/conductor
cd conductor
npm install
npm run dev        # Watch mode
npm test           # Run tests (Vitest)
npm run typecheck  # Type check
npm run lint       # ESLint (requires Node >= 20.12)

要求：Node >= 20.12，npm >= 9。

---

许可证

Apache 2.0 — 详见 LICENSE

由 Alexander Wondwossen 和贡献者打造。