Infra MCP Agent

inframcp代理🚀

用于Kubernetes基础设施自动化的最小控制平面（MCP）服务器和客户端。使用Python和FastAPI构建，专为在AKS或任何Kubernetes集群内安全、结构化的任务执行而设计。

______________________________________________________________________

🧠 为什么这个项目存在

现代基础设施团队通常需要轻量级、安全的方法来将内部操作（如扩展部署或重启Pod）暴露给自动化工具、人工智能代理或内部仪表板。该项目通过提供：

• ✅ 基于FastAPI的MCP服务器，接收结构化JSON任务
• ✅ 一个安全发送任务的Python客户端
• ✅ 基于令牌的身份验证
• ✅ 使用官方Python客户端的Kubernetes原生操作

无论您是在构建内部工具、与LLM集成，还是自动化DevOps工作流程， infra-mcp-agent 为您提供了一个干净、可扩展的控制界面。

______________________________________________________________________

📦 特性

______________________________________________________________________

🧱 建筑

Client → API Gateway → MCP Server → Kubernetes API

• MCP服务器：接收和路由任务的FastAPI应用程序
• MCP客户端：发送任务的Python CLI或SDK
• 认证：基于令牌（存储在Kubernetes Secret或Azure密钥库中）
• Kubernetes集成：用途 kubernetes 开发包

______________________________________________________________________

🚀 入门指南

1.克隆回购

git clone https://github.com/AbhuSteyn/infra-mcp-agent.git
cd infra-mcp-agent

2.构建并推送Docker镜像

docker build -t yourusername/infra-mcp-agent:latest .
docker push yourusername/infra-mcp-agent:latest

3.部署到AKS

kubectl apply -f manifests/deployment.yaml
kubectl apply -f manifests/service.yaml

💡 确保创建一个名为的Kubernetes Secret mcp-secret 使用您的令牌：

kubectl create secret generic mcp-secret --from-literal=token=your-secure-token

______________________________________________________________________

🧪 使用MCP客户端

from src.client import send_task

task = {
  "task": "scale_deployment",
  "namespace": "default",
  "deployment_name": "web-api",
  "replicas": 3
}

response = send_task(task, token="your-token")
print(response)

______________________________________________________________________

🔧 任务有效载荷示例

✅ 重新启动Pod

{
  "task": "restart_pod",
  "namespace": "default",
  "pod_name": "my-app-pod"
}

📈 扩展部署

{
  "task": "scale_deployment",
  "namespace": "default",
  "deployment_name": "web-api",
  "replicas": 5
}

📦 应用清单

{
  "task": "apply_manifest",
  "manifest": ""
}

______________________________________________________________________

🧪 测试

使用模拟运行单元测试：

python -m unittest tests/test_kube_ops.py

______________________________________________________________________

🔐 安全说明

• 所有请求都必须包含有效的承载令牌
• 根据环境变量验证令牌(MCP_AUTH_TOKEN)
• 推荐：将令牌存储在Azure密钥库或Kubernetes Secrets中
• 可选：扩展以支持mTLS或OAuth2

______________________________________________________________________

📚 扩展项目

您可以通过以下方式轻松添加新任务：

1. 在中定义新函数 kube_ops.py
2. 在中添加路线 task_router.py
3. 更新客户端负载

______________________________________________________________________

📄 许可证

MIT许可证。请随意分叉、扩展和贡献。

______________________________________________________________________

______________________________________________________________________

您是否需要帮助编写GitHub Actions工作流以自动化测试和Docker构建？或者可以使用示例Helm chart在AKS中更干净地部署它？