Claude执行桥接工具

Conductor是一个MCP服务器,允许Claude Desktop通过Claude Code的功能执行任务,实现文档处理、终端命令和代码编辑。

  • by ariaxhan
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 ariaxhan/conductor

使用说明

指挥

通过MCP+Agent SDK在Claude Desktop和Claude Code之间架起桥梁。

Conductor是一个MCP服务器,允许Claude Desktop使用Claude Code的功能执行任务。从桌面发送视觉文档、提示或指令,并通过完全文件访问、终端命令和代码编辑观看它们的执行。

运作原理

Claude Desktop  ──MCP──►  Conductor  ──Agent SDK──►  Claude Code
     ▲                                                    │
     └────────────────── results ─────────────────────────┘
  1. Claude Desktop通过MCP(stdio)连接到Conductor
  2. 桌面调用带有提示/视觉文档的Conductor工具
  3. Conductor使用Agent SDK执行Claude Code的功能
  4. 结果流回到桌面

设置

1.安装依赖项

cd conductor
npm install

2.设置API密钥

cp .env.example .env
# Edit .env and add your ANTHROPIC_API_KEY

从获取API密钥 console.anthropic.com.

3.建造

npm run build

4.配置克劳德桌面

将Conductor添加到Claude Desktop MCP配置中(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "conductor": {
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/Documents/conductor/dist/index.js"],
      "env": {
        "ANTHROPIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

替换 YOUR_USERNAME 使用您的实际用户名并添加您的API密钥。

5.重新启动克劳德桌面

退出并重新打开Claude Desktop以加载新的MCP服务器。

工具

set_project

设置后续执行的工作目录。

set_project({ path: "/Users/you/projects/myapp" })

execute

使用Claude Code的全部功能执行任何提示。

execute({
  prompt: "Find all TODO comments and create a summary",
  project: "/path/to/project",  // optional if set_project was called
  allowedTools: ["Read", "Glob", "Grep"]  // optional, defaults to all
})

execute_vision

执行愿景/规划文件。专为规划会议的交接而设计。

execute_vision({
  vision: "# Feature: User Authentication\n\n...",
  flowcharts: "```mermaid\n...\n```",  // optional
  project: "/path/to/project",
  instruction: "start with tests"  // optional
})

continue_session

按照后续说明继续上一节课。

continue_session({
  prompt: "Now add error handling to what you just built"
})

get_status

获取当前Conductor状态(项目、会话信息)。

示例用法

在克劳德桌面中:

“使用导体将项目设置为~/projects/myapp”

“使用导体执行:分析代码库结构并确定主要入口点”

“使用导体执行此愿景文档中的_vision:[粘贴您的vision.md内容]”

“使用conductor继续会话:现在为刚刚实现的内容编写测试”

安全说明

导线与 bypassPermissions 模式,意味着Claude Code可以在没有提示的情况下读取、写入和执行命令。这是为了实现无缝自动化,但意味着您应该:

  • 仅在受信任的项目上使用
  • 检查你要求它执行的内容
  • 考虑文件/命令访问的影响

发展

# Run in development mode
npm run dev

# Type check
npm run typecheck

# Build for production
npm run build

版本

  • 代理软件开发工具包:0.2.4
  • MCP SDK:1.25.2