智能开发助手系统

基于Model Context Protocol的智能助手系统,提供代码分析、组件生成、架构建议等功能,适用于iOS和Python开发者。

  • by kikiloveswift
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 kikiloveswift/mcp

使用说明

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 服务器

  1. iOS 开发助手 - 提供 iOS 开发相关的工具和资源

    • Xcode 项目分析
    • CocoaPods/SPM 依赖管理
    • SwiftUI/UIKit 代码片段
    • iOS 最佳实践建议
  2. 代码分析器 - 智能代码分析

    • Swift/OC 代码质量检查
    • 性能优化建议
    • 安全漏洞检测
    • 代码复杂度分析
  3. 文件管理器 - 高级文件操作

    • 项目文件搜索
    • 批量文件处理
    • 代码重构支持
    • Git 集成
  4. 数据处理器 - 数据分析和处理

    • JSON/Plist 解析
    • API 测试工具
    • 数据转换
    • Mock 数据生成

AI Agents

  1. 代码审查 Agent - 自动化代码审查

    • Pull Request 分析
    • 代码风格检查
    • 潜在 Bug 发现
    • 优化建议
  2. 文档生成 Agent - 智能文档生成

    • API 文档生成
    • README 自动化
    • 代码注释补全
    • 多语言支持
  3. 测试生成 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 新手,建议按以下顺序学习:

  1. 📖 阅读 docs/01-mcp-basics.md - 了解 MCP 基础
  2. 🔨 运行 examples/simple-mcp-server/ - 第一个 MCP 服务器
  3. 🤖 探索 agents/code-reviewer/ - 创建你的第一个 Agent
  4. 📱 查看 ios-client/swift-example/ - iOS 集成
  5. 🚀 构建自己的 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 之旅! 🚀