🌿 GreenOps：碳意识计算路由代理
适用于亚太地区Google Cloud Gen AI Academy的Winner-Ready无服务器解决方案——第2轨。
GreenOps是一个自主、100%无服务器、零成本的人工智能代理，由 谷歌代理开发工具包（ADK） 和那个 模型上下文协议（MCP）发展成为一个积极主动的 混合大师，它不仅仅将计算工作负载路由到最干净的Google Cloud区域，它还积极协调时态、财务和空间域以优化您的基础设施。
______________________________________________________________________
🚀 现场演示
- 交互式Web用户界面: GreenOps ADK Web界面
- FastMCP API终点:
https://greenops-mcp-73907097560.us-central1.run.app/sse
______________________________________________________________________
✨ 主要特征和大师组合
- 空间大师（碳路线）： 询问官方
bigquery-public-data.google_cfe.datacenter_cfe数据集以推荐最佳部署区域（例如。，europe-north2在100%CFE下运行）。 - 时间大师（天气预报）： 整合免费 开放天气 API预测即将到来的风能和太阳能高峰，使代理商能够建议推迟工作量以实现最大的碳效率。
- FinOps Master（成本本地化）： 使用 法兰克福香肠 FX API可即时将美元云成本估计值转换为您的本地货币。
- 自主测试大师（QA）： 具有专用的Python测试管道(
tests/testing_master.py)利用pytest和一个孤立的LlmAgent定期吸烟测试编排器和旗帜幻觉。 - 零财务成本： 严格针对“始终免费”级别进行架构设计。一切都在Google Cloud Run和BigQuery的免费层内运行，使其在全球范围内以零边际成本访问。
______________________________________________________________________
🛠️ 建筑
GreenOps利用FastMCP的令牌高效架构将ADK桥接到域Masters：
sequenceDiagram
participant User as User
participant Agent as Agent Orchestrator (Cloud Run)
participant FastMCP as FastMCP Server (Cloud Run)
participant External as External Masters (BQ, Weather, FX)
User->>Agent: Submits Workload (e.g., $45 Batch Job)
activate Agent
Agent->>FastMCP: Calls Specialized Tools
activate FastMCP
FastMCP->>External: Evaluates Carbon, Forecasts, and Cost
activate External
External-->>FastMCP: Ranked Carbon Metrics / Forecasts / AUD
deactivate External
FastMCP-->>Agent: Filtered JSON Payload
deactivate FastMCP
Agent-->>User: Streams Cleanest Spatial & Temporal Recommendation
deactivate Agent组件分解
- ADK代理服务(
greenops_agent/agent.py)：由Google Gemini 2.5 Flash提供支持，作为用户对话的编排器。通过定制的FastAPI包装安全地提供服务。 - FastMCP服务器(
mcp_server/main.py)：符合模型上下文协议的数据连接器。公开映射到BigQuery、Open Meteo和Frankfurter API的语义工具。 - 测试大师(
tests/testing_master.py)：一个程序化评估框架，用于验证Orchestrator的SimpleMEM格式和约束遵守情况。
______________________________________________________________________
📦 本地开发
1.环境设置
git clone https://github.com/Danish2op/GreenOps-MCP-Agent.git
cd GreenOps-MCP-Agent
# Virtual Environment Setup
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt2.配置环境变量
创建一个 .env 使用提供的模板创建文件：
cp .env.example .env
# Edit `.env` to include your GOOGLE_API_KEY and GCP_PROJECT_ID3.启动架构
您必须同时启动MCP服务器和代理应用程序：
# Terminal 1: Start the MCP Server
python -m mcp_server.main
# Terminal 2: Start the Hardened ADK Web UI
python agent_app.py______________________________________________________________________
🚢 部署（谷歌云运行）
GreenOps针对容器化部署进行了优化。
部署MCP服务器
gcloud run deploy greenops-mcp \
--source . \
--region us-central1 \
--allow-unauthenticated \
--project greenops-agent部署ADK代理应用程序
# IMPORTANT: Move Dockerfiles temporarily to ensure correct target builds
mv Dockerfile.agent Dockerfile
gcloud run deploy greenops-agent-app \
--source . \
--region us-central1 \
--allow-unauthenticated \
--project greenops-agent
git restore Dockerfile______________________________________________________________________
📊 验证指标
代理安全地使用经验证的API数据，并成功识别以下指标：
- 全球最清洁地区:
europe-north2（芬兰）持续运营 100%CFE. - 美国最清洁地区:
us-south1（达拉斯）在 94%CFE.
______________________________________________________________________
📄 许可证
麻省 理工© 2026 丹麦 Sharma