Sub Agent MCP

子代理MCP——革命性的人工智能集成平台

语言: 🇺🇸 英语 | 🇮🇩 印度尼西亚语

跨开发环境无缝集成人工智能的两种革命性方法

______________________________________________________________________

🌟 概述

子代理MCP为开发工具中的AI集成引入了两种突破性的范式：

1. 🌉 MCP VoidEditor桥 -具有完整IDE功能的直接子代理控制
2. 🔗 MCP本地提供商 -适用于任何IDE的通用AI模型适配器

这两种方法都改变了开发人员在不同环境中与人工智能交互的方式，在保持安全性和用户控制的同时创建了无缝的工作流程。

______________________________________________________________________

🎯 愿景

传统问题

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│   Cursor    │    │ VoidEditor  │    │ Other IDEs  │
│   Agent     │ ≈≈►│   Manual    │ ≈≈►│   Manual    │
│ (Powerful)  │    │ (Limited)   │    │ (Limited)   │
└─────────────┘    └─────────────┘    └─────────────┘

我们的解决方案

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│   Cursor    │◄──►│ MCP Bridge  │◄──►│ VoidEditor  │
│ Main Agent  │    │ (Direct)    │    │ Sub-Agent   │
│ (Primary)   │    │             │    │ (Extended)  │
└─────────────┘    └─────────────┘    └─────────────┘
         │                                    │
         │                                    │
         └─────────────── OR ─────────────────┘
                         │
                ┌─────────────────┐
                │ Local Provider  │◄──► Any IDE
                │ (Universal)     │    (AI Model)
                └─────────────────┘

______________________________________________________________________

🚀 两种革命性的方法

🌉 方法1:MCP VoideEditor桥

“主代理/子代理”范式

将VoidEditor转换为扩展环境，在该环境中，游标主代理可以通过具有完整IDE功能的子代理进行操作。

主要特点

• 直接控制：子代理以完整的IDE功能运行
• 同意驱动：每个操作都需要明确的用户批准
• 临时会议：具有自动清理功能的限时访问
• 实时透明度：实时活动馈送和审计跟踪

用例

• 需要直接IDE控制的复杂开发工作流程
• 需要精细权限管理的团队
• 需要完整审计跟踪的组织

技术架构

Cursor Agent ←→ MCP Bridge ←→ VoidEditor Plugin
     │              │              │
   Context      Session Mgmt    Full IDE Ops
   Knowledge    Security        Real-time Sync

🔗 方法2:MCP本地提供商

“AI模型共享”范式

把Cursor想象成一台具有WiFi（人工智能功能）的笔记本电脑，把VoidEditor想象成一部使用笔记本电脑热点的手机。本地提供者与任何兼容的IDE共享Cursor的AI模型。

主要特点

• 通用兼容性：适用于任何支持本地AI提供商的IDE
• 零IDE修改：使用标准OpenAI/Ollama API端点
• 上下文保护：所有工具都提供完整的光标上下文
• 无缝集成：IDE认为它正在与本地模型通信

用例

• 多IDE开发团队
• 使用各种编辑器的开发人员
• 需要一致人工智能体验的组织

技术架构

Any IDE ←→ Local Provider Adapter ←→ Cursor Agent
   │              │                      │
Standard API   Translation Layer    Full Context
OpenAI/Ollama  MCP Protocol        Knowledge Base

类比：光标（支持WiFi的笔记本电脑）→ 本地提供商（热点）→ VoidEditor（使用热点的手机）

______________________________________________________________________

🎨 什么时候使用哪种方法？

选择 MCP电桥 什么时候：

• ✅ 您需要直接的IDE控制（文件操作、终端命令）
• ✅ 您需要精细的权限管理
• ✅ 您需要完整的审计跟踪
• ✅ 您主要使用的是VoidEditor
• ✅ 您需要实时透明度

选择 本地供应商 什么时候：

• ✅ 您使用多个IDE并希望保持一致性
• ✅ 您更喜欢标准的AI模型集成
• ✅ 您不希望对IDE进行任何修改
• ✅ 您需要通用兼容性
• ✅ 您希望简化设置

______________________________________________________________________

🏗️ 体系结构比较

______________________________________________________________________

🚀 快速开始

选项1:MCP桥（直接控制）

# Clone the repository
git clone https://github.com/your-org/sub-agent-mcp.git
cd sub-agent-mcp

# Navigate to bridge
cd bridge

# Follow bridge setup
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Start bridge
python -m bridge.mcp_bridge

选项2：本地提供商（通用模式）

# Clone the repository
git clone https://github.com/your-org/sub-agent-mcp.git
cd sub-agent-mcp

# Navigate to local provider
cd local_provider

# Follow provider setup
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Start provider
python -m local_provider.adapter

______________________________________________________________________

📚 文档结构

🌉 桥梁文件

• README.md -桥梁概述和快速启动
• 蓝色印花.md -技术规格
• 建筑.md -系统架构
• API_规范.md -API文件
• 部署.md -部署指南
• 实施.md -代码示例
• 测试.md -测试策略
• ide.md -核心概念和哲学

🔗 本地供应商文件

• README.md -提供商概述和快速入门
• 建筑.md -系统架构
• API_规范.md -API文件
• 部署.md -部署指南
• 实施.md -代码示例
• 测试.md -测试策略
• ide.md -核心概念和哲学

🌍 印尼文件

• docs_id/README.md - 印度尼西亚语的主要文档
• 桥/docs_id/ - Bridge 印度尼西亚文档
• 本地_提供者/docs_id/ - 印度尼西亚语本地提供商文档

______________________________________________________________________

🎯 核心概念

子代理范式

这两种方法都实现了 子代理范式 其中AI助手可以在不同的环境中操作，同时保持上下文和功能。

安全第一

• 同意驱动访问：所有操作都需要明确的用户批准
• 临时会议：具有自动清理功能的限时访问
• 审计跟踪：完整记录所有人工智能操作
• 本地主机绑定：所有通信都保持在本地机器上

通用兼容性

• 标准API：使用OpenAI/Ollama兼容的端点
• 零修改：不需要更改IDE
• 交叉平台的：适用于Windows、macOS和Linux

______________________________________________________________________

🔮 未来路线图

第一阶段：核心系统(✅)

• \[x\] MCP网桥实施
• \[x\] 本地提供商实施
• \[x\] 安全框架
• \[x\] 文件

第二阶段：增强功能

• \[\]多代理协调
• \[\]高级上下文共享
• \[\]性能优化
• \[\]企业功能

第三阶段：生态系统增长

• \[\]额外的IDE支持
• \[\]社区插件
• \[\]市场功能
• \[\]开发人员工具

第四阶段：先进的人工智能

• \[\]跨IDE学习
• \[\]协作代理
• \[\]专业型号
• \[\]研究平台

______________________________________________________________________

🤝 贡献

我们欢迎捐款！请参阅我们的投稿指南：

1. 选择你的方法：决定是向Bridge还是本地提供商捐款
2. 阅读文档：熟悉所选系统
3. 遵循标准：使用既定的编码和文件标准
4. 彻底测试：确保所有更改都经过适当测试
5. 文档更改：更新相关文件

开发设置

# Clone repository
git clone https://github.com/your-org/sub-agent-mcp.git
cd sub-agent-mcp

# Install dependencies for both systems
pip install -r bridge/requirements.txt
pip install -r local_provider/requirements.txt

# Run tests
pytest bridge/tests/
pytest local_provider/tests/

______________________________________________________________________

📊 成功指标

技术指标

• 桥：会话成功率>99%，响应时间\80%的功能采用率
• 满意：>4.5/5用户满意度
• 效率：上下文切换时间减少30%以上

商业米制公约

• 生产力：可测量的开发人员生产力提高
• 协作：改善跨团队协作
• 质量：增强的代码质量指标

______________________________________________________________________

🛡️ 安全与隐私

核心原则

• 零信任架构：每个请求都经过验证
• 隐私设计：无持久数据存储
• 仅限本地主机：所有通信都保持在本地
• 使用者同意：明确批准所有操作

合规

• 审核就绪：完整记录合规性
• 叫做数据缩小：只收集必要的数据
• 撤销权：用户可以随时撤销访问权限
• 透明操作：全面了解人工智能行动

______________________________________________________________________

🌍 社区与支持

获取帮助

• 文档：两种方法的综合指南
• 问题：GitHub发布错误报告和功能请求
• 讨论：社区讨论问题和想法
• 电子邮件：为企业用户提供直接支持

社区准则

• 恭敬的：尊重所有社区成员
• 建设性的：提供建设性的反馈和建议
• 包容的：欢迎来自不同背景的贡献者
• 协作的：共同努力改进平台

______________________________________________________________________

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

______________________________________________________________________

🙏 致谢

• Cursor团队：用于创新的AI驱动开发环境
• VoidEditor社区：适用于轻量级、可扩展的编辑器
• 开源社区：为了使这成为可能的工具和库
• 贡献者：感谢他们的宝贵贡献和反馈

______________________________________________________________________

子代理MCP代表了我们对开发工具中AI集成方式的根本转变。无论您选择直接控制网桥还是选择本地提供商的通用兼容性，您都在参与人工智能辅助开发的未来。

选择你的方法，改变你的工作流程，加入人工智能驱动的开发革命。