Unico Finops MCP

UnicoFinOps：上下文感知的云成本代理🛡️💰

问题： 标准的AI编码代理对Infrastructure as Code来说是危险的。他们建议在不了解隐藏依赖关系的情况下删除“空闲”资源，从而导致生产中断。 解决方案： UnicoFinOps是一个 MCP服务器 构建实时 依赖图 您的基础设施。它阻止了危险的操作 *之前* 它们发生，然后使用 谷歌双子座3 制定合理的策略，安全地节省约90%的开支。

______________________________________________________________________

🏗️ 建筑

该项目是在 脑谷AIE代码代理黑客马拉松（纽约2025） 使用多代理架构：

graph LR
    User[IDE / Cursor] -->|MCP Protocol| Server[UnicoFinOps Server]
    Server -->|Parse| HCL[Terraform Files]
    HCL -->|Build| Graph[NetworkX Dependency Graph]
    
    Graph -->|Safety Check| Gate{Safe to Modify?}
    Gate -- No --> Block[🚨 BLOCK & WARN]
    Gate -- Yes --> AI[Google Gemini 3]
    
    AI -->|Optimize| FinOps[Cost Analysis]
    FinOps -->|Review| Rabbit[CodeRabbit AI]
    FinOps -->|Persist| Mongo[MongoDB Atlas]

🚀 主要特点

1. 🛡️ 基于图的安全门（NetworkX）

与“基于文本”的代理不同，UnicoFinOps构建了AWS资源的有向图。

• 功能：检测连接的卷、安全组引用和IAM角色依赖关系。
• 结果：如果下游资源依赖于目标，则显式阻止DELETE操作。

1. 🧠 出血边缘推理（谷歌双子座3预览版）

利用Gemini 3的大规模上下文窗口和推理能力。

• 能力：分析完整的tfstate上下文以识别“僵尸基础设施”
• 结果：根据实际的CloudWatch指标，确定gp2与gp3的低效率，并将t3.2x放大到t3.medium。

1. 🤝 协同治理（CodeRabbit）

我们将AI视为合作伙伴，而不仅仅是工具。

• 工作流：代理打开Pull Request->CodeRabbit检查代码的安全性/合规性->人工合并。
• 验证：CodeRabbit在部署之前强制执行生产标准（错误处理、重试）。

1. 💾 状态感知（MongoDB Atlas）

• 使用MongoDB来维护优化历史，防止代理“摆动”（建议两次进行相同的修复）。

______________________________________________________________________

🛠️ 技术栈和赞助商

• 型号：谷歌双子座3预览版（Gemini-3-pro-review）
• 协议：模型上下文协议（MCP）fastmcp
• 数据库：MongoDB Atlas（Python驱动程序）
• CI/CD：CodeRabbit AI
• 基础设施：Terraform/AWS
• 语言：Python 3.12（FastAPI）

______________________________________________________________________

⚡ 快速开始

先决条件

• Python 3.12+
• Google Gemini API密钥
• MongoDB Atlas URI

安装

1.克隆回购

git clone https://github.com/BorisQuanLi/unico-finops-mcp.git
cd unico-finops-mcp

2.安装依赖项

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

3.配置环境 创建一个 .env 文件：

GEMINI_API_KEY=your_key_here
MONGODB_URI=your_mongo_uri

4.运行演示 运行模拟脚本以查看Graph Safety Guard的运行情况：

python test_demo.py

______________________________________________________________________

📜 许可证 该项目是Apache 2.0许可证下的开源项目。

### 🚀 Commit & Push

Run these commands to update the repo immediately:

git add README.md git commit -m "docs: update README with architecture, graph safety logic, and sponsor details" git push