使用说明
🚀 DevOps-MCP —— DevOps的多上下文协议服务器
DevOps-MCP(注:MCP在此处可能是一个特定上下文中的缩写或专有名词,没有直接的中文翻译,但根据常规理解,可以将其保留为原样或根据具体上下文进行适当解释。) 是一个智能助手 模型上下文协议(MCP) 构建服务器,让DevOps工程师的工作顺心如意
从每日站会到Kubernetes健康检查,从未读的GitHub拉取请求到Gmail摘要——所有这些都通过一个单一的界面进行整合。
🎥 演示
观看以下全屏录制的演示视频:
https://github.com/shaikhameed1243-art/mcp-devops/blob/main/MCP%20-%20Demo.mp4(中文翻译可表述为):https://github.com/shaikhameed1243-art/mcp-devops/(主分支)/MCP - 示例演示.mp4
✨ 它的功能
这个MCP服务器将您的大型语言模型(如Claude、OpenAI MCP客户端等)连接到您的 DevOps生态系统 — 安全且模块化地。
| 集成 | 目的 |
|---|---|
| 🧠 克劳德/OpenAI MCP客户端 | 提出类似“开发环境中哪些Pod正在崩溃?”这样的自然语言问题 |
| 蜗牛 GitHub | 列出仓库、拉取请求和CI工作流 |
| 日期 Google 日历 | 获取今天的会议、即将可用的时间段和时间窗口 |
| 📧(电子邮件图标,无实际文字含义) Gmail(一种电子邮件服务) | 汇总未读或新消息 |
| ☸️ Kubernetes(中文常译为“K8s”,但“Kubernetes”本身也是被广泛接受的译名) | 监控Pod、部署、事件和资源使用情况 |
| ⚙️ GitHub Actions(GitHub 操作) | 检查失败的工作流或构建状态 |
| 💬 每日简报 | 跨所有工具的一次性提示摘要 |
🧩 架构/建筑
Claude ↔ MCP Inspector ↔ DevOps-MCP Server
├── GitHub Tools
├── Gmail + Calendar
├── Kubernetes Cluster
├── GitHub Actions
├── Daily Brief Prompt
所有工具均遵循 MCP规范 并公开任何大型语言模型(LLM)客户端都能发现的功能。
🛠️ 技术栈
- 🐍 Python 3.11+
- ⚙️ FastMCP(
mcp.server.fastmcp) - ☸️ Kubernetes Python SDK(Kubernetes Python软件开发工具包)
- 📦 箱子/包裹
httpx,dotenv,anyio - 🧠 克劳德/OpenAI MCP 检查器
- 🐳 Minikube 或任何 K8s 集群
⚙️ 设置(本地)
# 1️⃣ Clone & enter
git clone https://github.com/<yourname>/devops-mcp.git
cd devops-mcp
# 2️⃣ Create virtual environment
python -m venv .venv
.venv\Scripts\activate
# 3️⃣ Install dependencies
pip install -r requirements.txt
# 4️⃣ Set environment variables
cp .env.example .env
# Then add your tokens:
# GITHUB_TOKEN=ghp_xxxxxxxxxx
# GOOGLE_CREDENTIALS_PATH=path/to/creds.json
# KUBECONFIG=C:\Users\<user>\.kube\config
# 5️⃣ Start the MCP server
$env:PYTHONPATH = (Resolve-Path .\src).Path
npx @modelcontextprotocol/inspector -- python -m devops_mcp.server
🧠 示例提示(来自Claude)
me: what pods are running in default?
→ k8s_pods(ns="default")
me: show events in kube-system
→ k8s_events(ns="kube-system", limit=10)
me: list my GitHub repos
→ gh_list_repos()
me: daily brief for my DevOps day
→ daily_brief_prompt()
🌐 支持的MCP工具
| 工具 | 描述 |
|---|---|
| (无对应中文翻译,表示表格边框) | (无对应中文翻译,表示表格边框) |
| 列出你的GitHub仓库 | gh_list_prs |
| 获取任何仓库的拉取请求(PRs) | gha_failing_runs |
| 显示失败的GitHub Actions工作流 | gmail_unread |
| 列出未读邮件 | meetings_today |
| 显示今天的日历会议 | k8s_pods |
| Kubernetes 监控工具包 | daily_brief |
| 生成简洁的每日总结 |
minikube start --driver=docker
kubectl create deploy hello --image=nginx
kubectl expose deploy hello --port=80
kubectl get pods -A
🧩 示例:K8s 集群健康状况
然后问克劳德:
“默认部署的状态如何?”
“kube-system 中按 CPU/内存排序的顶级 Pod”
devops-mcp/
│
├── src/
│ └── devops_mcp/
│ ├── server.py # MCP entrypoint
│ └── tools/
│ ├── github_list_repos.py
│ ├── gmail.py
│ ├── calendar.py
│ ├── k8s_cluster.py
│ ├── k8s_events.py
│ ├── k8s_top.py
│ ├── k8s_deploys.py
│ └── ci_github_actions.py
│
├── .env.example
├── requirements.txt
└── README.md
🧱 文件夹结构
💡 愿景
这不仅仅是一个普通的自动化脚本—— 这是个连接您的DevOps技术栈与AI推理的桥梁
, 一个能说话的壳自然语言和上下文
。
“让日常渐入沉寂,
让自动化悄然传递信号。“
📬 作者 哈米德
— DevOps工程师 · 通用人工智能Python开发人员 · 作家 💻 GitHub(代码托管平台):
@shaikhameed(用户名或特定标识,可译为“谢赫·阿米尔”或保持原样,具体根据上下文确定) 💬 LinkedIn(领英):
linkedin.com(领英网站)
“DevOps不应是一场日常的战斗。它应该是一场交响乐——