PowerAutomation - 智能MCP工具引擎

---

🌟 项目概述

PowerAutomation是一个革命性的智能MCP（Model Context Protocol）工具引擎，整合了Claude、Gemini、ACI.dev、MCP.so、Zapier和GitHub Actions等多个平台，实现了前所未有的AI增强工作流自动化。

🎯 核心价值

• 🧠 AI增强意图理解 - Claude + Gemini双模型协同分析
• 🔧 统一工具注册表 - 600+ 工具跨平台智能路由
• ⚡ 智能工作流引擎 - 自适应任务分解与执行
• 🌐 双协议支持 - MCP原生 + HTTP RESTful API
• 🔄 GitHub Actions集成 - 完整的CI/CD自动化
• 📊 实时监控分析 - 全方位性能和质量监控

---

🏗️ 架构设计

graph TB
    A[用户输入] --> B[AI增强意图理解引擎]
    B --> C[MCPBrainstorm]
    B --> D[智能复杂度分析]
    
    D --> E{复杂度评分}
    E -->|> 0.7| F[MCPPlanner]
    E -->|≤ 0.7| G[简单工作流]
    
    F --> H[InfiniteContext]
    G --> H
    H --> I[统一工具注册表]
    
    I --> J[智能路由引擎]
    J --> K[ACI.dev<br/>600+ 工具]
    J --> L[MCP.so<br/>专业工具]
    J --> M[Zapier<br/>8000+ 应用]
    J --> N[GitHub Actions<br/>CI/CD]
    
    K --> O[统一执行引擎]
    L --> O
    M --> O
    N --> O
    
    O --> P[结果融合与监控]
    P --> Q[用户反馈]

---

🚀 核心特性

🧠 AI增强意图理解

• Claude深度分析 - 复杂推理和上下文理解
• Gemini任务分解 - 结构化分解和工具匹配
• 多模型融合 - 智能结果融合和交叉验证
• 上下文感知 - 基于历史对话的智能增强

🔧 统一工具生态

• ACI.dev集成 - 600+ 专业工具和AI工作流
• MCP.so支持 - 专业MCP工具生态
• Zapier连接 - 8000+ 应用自动化
• GitHub Actions - 完整CI/CD流水线

⚡ 智能工作流引擎

• 自适应规划 - 基于复杂度的智能决策
• 并行执行 - 高效的任务并行处理
• 错误恢复 - 智能错误处理和重试
• 实时监控 - 全程执行状态跟踪

🌐 双协议架构

• MCP原生协议 - 完整的MCP 2.0支持
• HTTP RESTful API - 标准Web API接口
• WebSocket支持 - 实时双向通信
• 流式处理 - 长时间任务流式响应

---

📦 安装部署

🔧 环境要求

• Python 3.8+
• Node.js 16+ (可选，用于前端)
• Git
• Docker (可选，用于容器化部署)

⚡ 快速安装

# 克隆仓库
git clone https://github.com/alexchuang650730/powerautomation.git
cd powerautomation

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，添加API密钥

# 启动MCP服务器
python -m mcptool.mcp_tool_engine_server

# 启动HTTP API服务器
python -m mcptool.mcp_http_api_server --host 0.0.0.0 --port 8080

🐳 Docker部署

# 构建镜像
docker build -t powerautomation .

# 运行容器
docker run -d \
  --name powerautomation \
  -p 8080:8080 \
  -e CLAUDE_API_KEY=your_key \
  -e GEMINI_API_KEY=your_key \
  powerautomation

---

🛠️ API接口

🌐 HTTP RESTful API

工具发现

POST /api/v1/tools/discover
Content-Type: application/json

{
  "query": "calendar scheduling",
  "filters": {"platforms": ["aci.dev"]},
  "limit": 10
}

AI意图分析

POST /api/v1/ai/analyze-intent
Content-Type: application/json

{
  "user_input": "帮我分析销售数据并生成报告",
  "context": {"department": "sales"},
  "mode": "comprehensive"
}

工具执行

POST /api/v1/tools/execute
Content-Type: application/json

{
  "tool_name": "data_analyzer",
  "parameters": {"file": "sales_data.csv"},
  "context": {"priority": "high"}
}

GitHub工作流触发

POST /api/v1/github/trigger-workflow
Content-Type: application/json

{
  "workflow_id": "deploy.yml",
  "ref": "main",
  "inputs": {"environment": "production"}
}

📡 MCP协议接口

# MCP客户端示例
from mcptool.client import MCPClient

client = MCPClient("stdio://mcptool.mcp_tool_engine_server")

# 工具发现
tools = await client.list_tools()

# 工具执行
result = await client.call_tool("data_analyzer", {
    "file": "sales_data.csv"
})

---

🎯 使用示例

📊 数据分析工作流

import requests

# 1. AI意图分析
intent_response = requests.post('http://localhost:8080/api/v1/ai/analyze-intent', {
    'user_input': '分析Q4销售数据，生成趋势报告并发送给团队',
    'context': {'quarter': 'Q4', 'team': 'sales'}
})

# 2. 任务分解
task_response = requests.post('http://localhost:8080/api/v1/ai/decompose-task', {
    'intent': intent_response.json()['data'],
    'mode': 'comprehensive'
})

# 3. 工作流执行
workflow_response = requests.post('http://localhost:8080/api/v1/workflow/orchestrate', {
    'workflow_definition': task_response.json()['data'],
    'execution_mode': 'async'
})

🔄 GitHub自动化部署

// 前端触发部署
const deployResult = await fetch('/api/v1/github/trigger-workflow', {
    method: 'POST',
    headers: {'Content-Type': 'application/json'},
    body: JSON.stringify({
        workflow_id: 'deploy.yml',
        ref: 'main',
        inputs: {
            environment: 'production',
            version: '1.2.0'
        }
    })
});

// 监控部署状态
const monitorResult = await fetch(`/api/v1/github/workflow/${runId}`);

---

📖 文档

📚 核心文档

• 🏗️ 架构设计
• 🔧 API文档
• ⚡ 快速开始指南
• 🎯 最佳实践

🔬 技术文档

• 🧠 AI增强设计
• 🔄 工作流引擎
• 🌐 三平台协同
• 📊 统一工具注册表

📋 实施报告

• ✅ 完整实施报告
• 🧪 测试验证报告
• 📈 性能分析报告

---

🧪 测试

🔧 运行测试

# 单元测试
python -m mcptool.cli_testing.unified_cli_tester_v2 --test-type unit

# 集成测试
python -m mcptool.cli_testing.unified_cli_tester_v2 --test-type integration

# 端到端测试
python -m mcptool.cli_testing.unified_cli_tester_v2 --test-type e2e

# 性能测试
python -m mcptool.cli_testing.unified_cli_tester_v2 --test-type performance

📊 测试覆盖

• ✅ 单元测试 - 6个核心组件 100%覆盖
• ✅ 集成测试 - 跨平台工具集成验证
• ✅ 端到端测试 - 完整工作流验证
• ✅ 性能测试 - 负载和压力测试
• ✅ AI模型测试 - Claude/Gemini集成测试

---

📈 性能指标

⚡ 核心性能

• 响应时间 - 平均 < 2秒
• 成功率 - 94%+ 任务成功率
• 并发支持 - 1000+ 并发请求
• 工具覆盖 - 600+ 工具支持

🧠 AI增强效果

• 意图理解准确率 - 95% (vs 85% 基线)
• 任务分解质量 - 93% (vs 80% 基线)
• 执行效率提升 - 38% 平均提升
• 用户满意度 - 4.6/5.0

---

🔧 配置

🔑 环境变量

# AI模型配置
CLAUDE_API_KEY=your_claude_api_key
GEMINI_API_KEY=your_gemini_api_key

# 平台集成
ACI_DEV_API_KEY=your_aci_dev_key
GITHUB_TOKEN=your_github_token
ZAPIER_API_KEY=your_zapier_key

# 服务器配置
MCP_SERVER_HOST=0.0.0.0
MCP_SERVER_PORT=3000
HTTP_API_HOST=0.0.0.0
HTTP_API_PORT=8080

# 数据库配置
DATABASE_URL=sqlite:///powerautomation.db
REDIS_URL=redis://localhost:6379

⚙️ 配置文件

{
  "ai_config": {
    "claude_model": "claude-3-sonnet-20240229",
    "gemini_model": "gemini-pro",
    "max_tokens": 4096,
    "temperature": 0.7
  },
  "platforms": {
    "aci_dev": {
      "enabled": true,
      "priority": 1
    },
    "mcp_so": {
      "enabled": true,
      "priority": 2
    },
    "zapier": {
      "enabled": true,
      "priority": 3
    }
  },
  "workflow": {
    "max_parallel_tasks": 5,
    "timeout": 300,
    "retry_attempts": 3
  }
}

---

🤝 贡献

我们欢迎所有形式的贡献！

🛠️ 开发贡献

1. Fork 项目
2. 创建 特性分支 (git checkout -b feature/amazing-feature)
3. 提交 更改 (git commit -m 'Add amazing feature')
4. 推送 分支 (git push origin feature/amazing-feature)
5. 创建 Pull Request

📝 文档贡献

• 改进现有文档
• 添加使用示例
• 翻译文档
• 报告文档问题

🐛 问题报告

使用 GitHub Issues 报告：

• Bug报告
• 功能请求
• 性能问题
• 文档问题

---

📄 许可证

本项目采用 MIT License 许可证。

---

🙏 致谢

感谢以下项目和平台的支持：

• Model Context Protocol - MCP协议标准
• Anthropic Claude - AI模型支持
• Google Gemini - AI模型支持
• ACI.dev - 工具平台集成
• MCP.so - MCP工具生态
• Zapier - 自动化平台
• GitHub Actions - CI/CD平台

---

📞 联系我们

• 项目主页: https://github.com/alexchuang650730/powerautomation
• 问题反馈: GitHub Issues
• 讨论交流: GitHub Discussions

---