🔍 MCP服务器监控系统
MCP服务器的完整监控和健康检查系统
______________________________________________________________________
📋 概述
一个全面的监控解决方案，确保您的 模型上下文协议（MCP）服务器 保持健康和联系。为使用MCP集成的开发人员构建。
🎯 这有什么作用
- ✅ 自动健康检查 -每5分钟监控一次所有MCP服务器
- 📊 每日报告 -服务器运行状况的自动摘要
- 🔧 诊断工具 -针对常见问题的内置诊断
- 🎨 颜色编码输出 -易于阅读的状态指示器
- 📝 综合录井 -随着时间的推移跟踪问题
- ⚡ 零配置 -开箱即用
______________________________________________________________________
🚀 快速开始
安装（一个命令）
git clone https://github.com/MuhammadTayyabIlyas/MCP_Monetring_Tool.git
cd MCP_Monetring_Tool
./setup-mcp-monitoring.sh
source ~/.bashrc检查服务器状态
mcp-status就是这样！ 🎉 您的MCP服务器现在已被自动监控。
______________________________________________________________________
✨ 特性
🔄 自动化监控
- 每5分钟进行一次基于Cron的健康检查
- 静音后台操作
- 自动原木轮换
- 无需人工干预
📈 详细报告
- 实时状态仪表板
- 每日总结报告（晚上11:59）
- 历史趋势分析
- 服务器通知失败
🛠️ 故障排除
- 依赖性验证
- API密钥验证
- 网络连接检查
- Python/Node.js环境检查
🎨 友善
- 颜色编码状态输出
- 易于阅读的摘要
- 快速访问别名
- 全面的文件
______________________________________________________________________
📦 包含什么
MCP_Monetring_Tool/
├── mcp-health-check.sh # Main health monitoring script
├── mcp-troubleshoot.sh # Diagnostic and troubleshooting tool
├── setup-mcp-monitoring.sh # Automated installation & setup
├── README.md # This file
└── .gitignore # Git ignore patterns______________________________________________________________________
🔧 支持的MCP服务器
此工具监视以下MCP服务器类型：
| 服务器 | 用途 | 状态检查 |
|---|---|---|
| 🦆 DuckDuckGo搜索 | 网络搜索功能 | uvx 可用性 |
| 🧠 顺序思维 | 高级推理 | npx 可用性 |
| 🎭 剧作家 | 浏览器自动化 | 二进制存在 |
| 💾 记忆 | 知识图持久化 | npx 可用性 |
| 📄 谷歌文档 | 文档集成 | 二进制+OAuth |
| 📊 谷歌表格 | 电子表格集成 | Python+OAuth |
| 📧 谷歌邮箱 | 电子邮件集成 | Python+OAuth |
| 📅 Google 日历 | 日历集成 | Python+OAuth |
| 📝 概念 | 工作空间集成 | Node.js+Token |
| 🎙️ 十一实验室 | 文本到速度 | Python+API键 |
| 🪟 Windows MCP | Windows自动化 | Python venv |
______________________________________________________________________
📊 用法
基本命令
检查服务器运行状况
mcp-status输出示例：
=== MCP Server Health Check ===
Time: 2025-11-17 21:32:25
Checking MCP Servers:
duckduckgo-search: ✓ OK
sequential-thinking: ✓ OK
playwright: ✓ OK
memory: ✓ OK
google-docs: ✓ OK
...
=== Summary ===
Total servers: 11
Healthy: 11
Failed: 0查看每日摘要
~/mcp-daily-summary.sh解决问题
~/mcp-troubleshoot.sh高级用法
监控特定服务器
mcp-status | grep "google-docs"实时日志监控
tail -f ~/.claude/mcp-health.log查看今天的失败
grep "FAILED" ~/.claude/mcp-health.log | grep "$(date +%Y-%m-%d)"重要工作前跑步
mcp-status && your-command______________________________________________________________________
⚙️ 配置
文件位置
| 文件 | 目的 | 位置 |
|---|---|---|
| 健康检查脚本 | 主监控脚本 | ~/mcp-health-check.sh |
| 安装脚本 | 安装自动化 | ~/setup-mcp-monitoring.sh |
| 疑难解答脚本 | 诊断工具 | ~/mcp-troubleshoot.sh |
| 运行状况日志 | 监控日志 | ~/.claude/mcp-health.log |
| Cron日志 | Cron作业输出 | ~/.claude/mcp-cron.log |
| 每日摘要 | 每日报告 | ~/.claude/mcp-daily-summary-*.txt |
自定义监控频率
编辑您的crontab：
crontab -e频率选项：
- 每5分钟（默认）：
*/5 * * * * - 每10分钟：
*/10 * * * * - 每小时：
0 * * * * - 每天两次（上午9点和下午9点）：
0 9,21 * * *
禁用/启用监控
禁用：
crontab -l | grep -v "mcp-health-check\|mcp-daily-summary" | crontab -重新启用：
./setup-mcp-monitoring.sh______________________________________________________________________
🐛 故障排除
Server Shows as FAILED
- 运行故障排除程序：
~/mcp-troubleshoot.sh- 检查具体错误：
mcp-status- 审核日志：
tail -50 ~/.claude/mcp-health.logElevenLabs Connection Issues
- 验证API密钥：https://elevenlabs.io/app/settings/api-keys
- 测试Python环境：
~/.venv/bin/python3 --version- 手动检查服务器：
~/.venv/bin/python3 ~/.venv/lib/python3.12/site-packages/elevenlabs_mcp/server.pyGoogle Services Not Working
重新验证：
rm ~/.local/state/google-docs-mcp/token.json
# Restart Claude Code to trigger OAuth flowNode.js Servers Failing
检查npx，必要时重新安装：
npx --version
sudo apt-get install npm # if needed______________________________________________________________________
📚 文档
运作原理
- 定时任务 跑
mcp-health-check.sh每5分钟 - 脚本检查 每个MCP服务器的可用性和依赖关系
- 记录结果 到
~/.claude/mcp-health.log - 每日总结 于晚上11:59生成，并附有统计数据
- 日志自动旋转 防止磁盘膨胀
建筑
┌─────────────────┐
│ Cron Scheduler │
└────────┬────────┘
│ (every 5 min)
▼
┌─────────────────────┐
│ mcp-health-check.sh │
└────────┬────────────┘
│
├──► Check Dependencies (Python, Node, uvx)
├──► Verify Binaries (Playwright, Google Docs)
├──► Validate API Keys (ElevenLabs, Notion)
├──► Test OAuth Tokens (Google Services)
│
▼
┌─────────────────┐
│ Log Results │
└────────┬────────┘
│
▼
┌─────────────────┐ ┌──────────────────┐
│ Real-time View │ │ Daily Summary │
│ (mcp-status) │ │ (11:59 PM) │
└─────────────────┘ └──────────────────┘______________________________________________________________________
💡 专业提示
1.添加到Shell启动
echo "mcp-status" >> ~/.bashrc现在，每次打开终端时，您都会看到服务器状态！
2.故障电子邮件提醒
# In crontab -e, modify the cron job:
*/5 * * * * ~/mcp-health-check.sh || echo "MCP servers down!" | mail -s "MCP Alert" your@email.com3.快速服务器检查
# Add to your .bashrc for instant checking
alias mcp='~/mcp-health-check.sh'4.编码前监控
mcp-status && code .
# or
mcp-status && claude______________________________________________________________________
🔐 安全与隐私
- ✅ API密钥存储在
~/.claude.json具有受限权限 - ✅ 日志中没有敏感数据（只有路径和状态）
- ✅ OAuth令牌单独存储在
.local/state/ - ✅ 所有脚本都在本地运行（无外部调用）
- ✅ 开源-自己审核代码
______________________________________________________________________
🤝 贡献
欢迎投稿！以下是您可以提供帮助的方式：
- 🐛 报告Bug -打开一个问题
- 💡 建议功能 -分享你的想法
- 🔧 提交PR -改进代码
- 📖 改进文档 -帮助他人理解
______________________________________________________________________
📝 许可证
该项目根据麻省理工学院许可证获得许可，详情见下文：
MIT License
Copyright (c) 2025 Muhammad Tayyab Ilyas
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.______________________________________________________________________
🌟 支持
如果你觉得这个工具有用：
- ⭐ 标记此存储库
- 🐛 报告问题
- 📢 分享
- 💬 提供反馈
______________________________________________________________________
📞 联系
穆罕默德·塔亚布·伊利亚斯
- github： @穆罕默德·塔亚比利亚斯
- 电子邮件：tayyabcheema777@gmail.com
______________________________________________________________________
🙏 致谢
- PAKEDX团队负责MCP监控开发
- 模型上下文协议贡献者
- 开源社区
______________________________________________________________________
由以下材料制成❤️ 通过PAKEDX