使用说明
MCP & AI Agents 项目
基于 Model Context Protocol 的智能助手系统
技术栈:Python + iOS (Swift/Objective-C)
🎯 项目概述
这个项目包含了一套完整的 MCP (Model Context Protocol) 服务器和 AI Agents,专门为 iOS 开发者和 Python 开发者设计。从零开始,手把手教你构建智能开发工具。
✨ 核心特性
- 🔧 7 个实用 MCP 工具 - 代码分析、组件生成、架构建议等
- 🤖 智能 AI Agent - 自动化代码审查和重构建议
- 📱 完整 iOS 客户端 - SwiftUI 示例应用
- 📚 详细中文文档 - 从入门到精通
- 💡 丰富示例代码 - 开箱即用的模板
- 🚀 生产就绪 - 包含错误处理、缓存、日志
🏗️ 项目架构
MCP/
├── mcp-servers/ # MCP 服务器实现
│ ├── ios-dev-assistant/ # iOS 开发助手服务器
│ ├── code-analyzer/ # 代码分析服务器
│ ├── file-manager/ # 文件管理服务器
│ └── data-processor/ # 数据处理服务器
├── agents/ # AI Agents 实现
│ ├── code-reviewer/ # 代码审查 Agent
│ ├── doc-generator/ # 文档生成 Agent
│ └── test-generator/ # 测试生成 Agent
├── ios-client/ # iOS 客户端示例
│ ├── swift-example/ # Swift 集成示例
│ └── objc-example/ # Objective-C 集成示例
├── docs/ # 文档
└── examples/ # 使用示例
🚀 核心功能
MCP 服务器
-
iOS 开发助手 - 提供 iOS 开发相关的工具和资源
- Xcode 项目分析
- CocoaPods/SPM 依赖管理
- SwiftUI/UIKit 代码片段
- iOS 最佳实践建议
-
代码分析器 - 智能代码分析
- Swift/OC 代码质量检查
- 性能优化建议
- 安全漏洞检测
- 代码复杂度分析
-
文件管理器 - 高级文件操作
- 项目文件搜索
- 批量文件处理
- 代码重构支持
- Git 集成
-
数据处理器 - 数据分析和处理
- JSON/Plist 解析
- API 测试工具
- 数据转换
- Mock 数据生成
AI Agents
-
代码审查 Agent - 自动化代码审查
- Pull Request 分析
- 代码风格检查
- 潜在 Bug 发现
- 优化建议
-
文档生成 Agent - 智能文档生成
- API 文档生成
- README 自动化
- 代码注释补全
- 多语言支持
-
测试生成 Agent - 自动生成测试用例
- XCTest 单元测试
- UI 测试用例
- Mock 对象生成
- 测试覆盖率分析
🚀 快速开始
前置要求
- ✅ Python 3.8+
- ✅ Xcode 14+ (iOS 开发)
- ✅ Git
5 分钟快速体验
# 1. 进入项目目录
cd /Users/liqiang/code/MCP
# 2. 安装依赖
pip install fastapi uvicorn aiofiles
# 3. 启动 HTTP 服务器
cd mcp-servers/ios-dev-assistant
python http_server.py
# 4. 在新终端测试
cd /Users/liqiang/code/MCP
python examples/test_mcp_server.py --mode interactive
详细指南: 查看 快速开始指南
iOS 客户端
将 ios-client/swift-example/ 中的文件添加到你的 Xcode 项目:
let client = MCPClient(baseURL: URL(string: "http://localhost:8080")!)
let code = try await client.generateSwiftUIComponent(type: "Button")
print(code)
🎓 学习路径
如果你是 MCP 新手,建议按以下顺序学习:
- 📖 阅读
docs/01-mcp-basics.md- 了解 MCP 基础 - 🔨 运行
examples/simple-mcp-server/- 第一个 MCP 服务器 - 🤖 探索
agents/code-reviewer/- 创建你的第一个 Agent - 📱 查看
ios-client/swift-example/- iOS 集成 - 🚀 构建自己的 MCP 服务器和 Agent
📚 文档
🛠️ 技术栈
- 后端: Python 3.8+, FastAPI, MCP SDK
- AI/ML: OpenAI API, LangChain, LlamaIndex
- iOS: Swift 5.7+, Objective-C, URLSession
- 工具: Git, Docker, pytest
🤝 贡献
欢迎贡献!请查看 CONTRIBUTING.md
📄 许可证
MIT License
📞 联系方式
- Issues: GitHub Issues
- Email: your-email@example.com
开始你的 MCP 和 AI Agents 之旅! 🚀