MCP Servers

A collection of Model Context Protocol servers, templates, tools and more.

T
Tencentos MCP Server
by @guoningzhang20
GitHub Repo(1 stars)

MCP Server for TencentOS Server — system telemetry, diagnostics, and recommendations

Created 4/17/2026
Updated about 4 hours ago
README
View Source
Repository documentation and setup instructions

TencentOS MCP Server

MCP Server for TencentOS Server — 系统遥测、故障诊断、补丁评估、合规审计、配置调优

基于 Model Context Protocol (MCP) 构建，让 AI 助手（如 CodeBuddy / Cursor / VS Code Copilot）能够直接读取和分析 TencentOS Server 系统状态。

✨ 核心特性

基础层 — 系统遥测（对标 Red Hat linux-mcp-server）

| 模块 | 工具 | 说明 | |------|------|------| | system_info | get_system_info / get_cpu_info / get_memory_info / get_disk_usage | OS、内核、CPU、内存、磁盘 | | processes | list_processes | 进程列表（按 CPU/内存排序） | | services | list_services / get_service_status | systemd 服务状态 | | network | get_network_info / get_network_connections | 网络接口、连接 | | storage | get_block_devices | 块设备 | | logs | query_logs | journalctl 日志查询 |

增强层 — 诊断与建议（TencentOS 独有）

| 模块 | 工具 | 解决的问题 | |------|------|-----------| | ① 补丁影响评估 | assess_patch_impact / list_security_advisories / check_patch_dependencies | 打补丁前评估对业务的影响，推荐修复策略 | | ② 故障诊断 | diagnose_system / get_error_timeline / check_resource_pressure | 多源日志关联分析，读懂机器状态 | | ③ 合规举证 | audit_operations / check_compliance / get_privileged_operations | 谁在什么时候操作了什么，审计取证 | | ④ 补丁版本管理 | get_patch_history / compare_patch_status / get_kernel_history | 补丁履历 + 版本 Gap 分析 + CVE 交叉比对 | | ⑤ 系统配置调优 | analyze_system_tuning / get_workload_profile / check_kernel_parameters | 负载画像 + 参数最佳实践对比 + 调优建议 |

🔒 所有操作均为只读。增强层仅提供诊断分析和建议，不会修改任何系统配置。

🚀 快速开始

方式一：源码安装

# 克隆仓库
git clone https://github.com/guoningzhang20/tencentos-mcp-server.git
cd tencentos-mcp-server

# 安装
pip install .

安装完成后，根据使用场景选择运行方式：

# ① stdio 模式（默认）— 由 MCP 客户端（IDE）自动拉起，不要手动执行
#    配置方法见下方「IDE 配置」章节
tencentos-mcp-server

# ② SSE 模式 — 启动 HTTP 服务，适合远程连接或多客户端共享
tencentos-mcp-server --transport sse --host 0.0.0.0 --port 8000

# ③ Streamable HTTP 模式 — MCP 最新推荐协议
tencentos-mcp-server --transport streamable-http --host 0.0.0.0 --port 8000

💡 注意：stdio 模式通过 stdin/stdout 与 MCP 客户端通信，直接在终端执行会看到进程"卡住"等待输入——这是正常行为，按 Ctrl+C 退出。如需手动测试，请使用 SSE 或 Streamable HTTP 模式。

三种传输模式对比：

| 模式 | 启动方式 | 适用场景 | |------|---------|---------| | stdio | MCP 客户端（IDE）自动拉起进程 | 本地 IDE 插件（CodeBuddy / Cursor），无需手动运行 | | sse | 手动启动 HTTP 服务，客户端连接 http://host:port/sse | 远程服务器、多客户端共享 | | streamable-http | 手动启动 HTTP 服务，客户端连接 http://host:port/mcp | MCP 协议最新标准，推荐新项目使用 |

方式二：容器运行（推荐生产使用）

# 构建
docker build -f Containerfile -t tencentos-mcp-server:latest .

# 运行（本地模式）
docker run -i --rm tencentos-mcp-server:latest

# 运行（SSH 远程模式）
docker run -i --rm \
  -v ~/.ssh:/root/.ssh:ro \
  -e TENCENTOS_MCP_HOST=192.168.1.100 \
  -e TENCENTOS_MCP_USER=ops \
  -e TENCENTOS_MCP_SSH_KEY_PATH=/root/.ssh/id_ed25519 \
  tencentos-mcp-server:latest

⚙️ IDE 配置

CodeBuddy / Cursor / VS Code

在 ~/.workbuddy/mcp.json（或对应 IDE 的 MCP 配置文件）中添加：

{
  "mcpServers": {
    "tencentos": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "${env:HOME}/.ssh:/root/.ssh:ro",
        "tencentos-mcp-server:latest"
      ],
      "env": {
        "TENCENTOS_MCP_HOST": "YOUR_SERVER_IP",
        "TENCENTOS_MCP_USER": "ops",
        "TENCENTOS_MCP_SSH_KEY_PATH": "/root/.ssh/id_ed25519"
      }
    }
  }
}

完整的配置示例参见 mcp-config-example.json。

🏗️ 架构

┌──────────────────────────────────────────────────────────┐
│                    AI Agent (IDE)                         │
│               CodeBuddy / Cursor / VS Code               │
└───────┬──────────────┬───────────────┬───────────────────┘
        │ stdio        │ SSE          │ Streamable HTTP
        │ (子进程)      │ (HTTP 长连接) │ (HTTP 双向流)
        │              │ /sse         │ /mcp
┌───────▼──────────────▼───────────────▼───────────────────┐
│              TencentOS MCP Server                        │
│                                                          │
│  ┌─────────────────────────────────────────────────────┐ │
│  │  传输层 (Transport)                                  │ │
│  │  stdio  │  SSE (uvicorn)  │  Streamable HTTP        │ │
│  ├─────────────────────────────────────────────────────┤ │
│  │  基础层 (Base)                                       │ │
│  │  system_info │ processes │ services                  │ │
│  │  network     │ storage   │ logs                      │ │
│  ├─────────────────────────────────────────────────────┤ │
│  │  增强层 (Enhanced) — TencentOS 独有                  │ │
│  │  patch_impact │ diagnostics │ compliance             │ │
│  │  patch_history│ system_tuning                        │ │
│  ├─────────────────────────────────────────────────────┤ │
│  │  执行层 (Executor)                                   │ │
│  │  本地 subprocess  ←→  SSH asyncssh                   │ │
│  └─────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────┘
                     │
          ┌──────────┴──────────┐
          ▼                     ▼
   ┌─────────────┐    ┌─────────────────┐
   │ TencentOS   │    │  TencentOS CVE  │
   │ Server      │    │  Database       │
   │ (本地/远程)  │    │  mirrors.       │
   │             │    │  tencent.com    │
   └─────────────┘    └─────────────────┘

📦 项目结构

tencentos-mcp-server/
├── pyproject.toml                    # 项目配置 & 依赖
├── Containerfile                     # 容器构建文件
├── README.md
├── LICENSE                           # Apache-2.0
├── mcp-config-example.json           # IDE MCP 配置示例
└── src/tencentos_mcp_server/
    ├── __init__.py
    ├── __main__.py                   # CLI 入口
    ├── server.py                     # FastMCP 实例 & 工具注册
    ├── executor.py                   # 命令执行抽象层
    ├── config.py                     # 配置管理
    ├── audit.py                      # 审计日志装饰器
    ├── models.py                     # Pydantic 数据模型
    ├── best_practices.py             # 调优最佳实践规则
    └── tools/
        ├── system_info.py            # 系统信息
        ├── processes.py              # 进程管理
        ├── services.py               # 服务状态
        ├── network.py                # 网络信息
        ├── storage.py                # 存储信息
        ├── logs.py                   # 日志查询
        ├── patch_impact.py           # ① 补丁影响评估
        ├── diagnostics.py            # ② 故障诊断
        ├── compliance.py             # ③ 合规举证
        ├── patch_history.py          # ④ 补丁版本管理
        └── system_tuning.py          # ⑤ 系统配置调优

🔑 环境变量

| 变量 | 说明 | 默认值 | |------|------|--------| | TENCENTOS_MCP_TRANSPORT | 传输协议（stdio / sse / streamable-http） | stdio | | TENCENTOS_MCP_BIND_HOST | SSE/HTTP 监听地址 | 127.0.0.1 | | TENCENTOS_MCP_BIND_PORT | SSE/HTTP 监听端口 | 8000 | | TENCENTOS_MCP_API_KEY | SSE/HTTP 模式的 Bearer Token 认证密钥 | — | | TENCENTOS_MCP_HOST | 目标主机 IP（空 = 本地执行） | — | | TENCENTOS_MCP_USER | SSH 用户名 | root | | TENCENTOS_MCP_SSH_KEY_PATH | SSH 私钥路径 | ~/.ssh/id_rsa | | TENCENTOS_MCP_SSH_PORT | SSH 端口 | 22 | | TENCENTOS_MCP_SSH_KNOWN_HOSTS | SSH known_hosts（auto/none/路径） | auto | | TENCENTOS_MCP_AUDIT | 启用工具调用审计日志 | true | | TENCENTOS_MCP_LOG_LEVEL | 日志级别 | INFO |

🔒 安全

设计原则

  • 全只读：所有 25 个工具均标记 readOnlyHint=True，不执行任何修改操作
  • 输入清理：所有用户输入参数经过 sanitize.py 白名单验证，防止命令注入
  • 审计日志：每次工具调用自动记录（可通过 TENCENTOS_MCP_AUDIT 开关）
  • 容器非 root：Containerfile 中以 mcp 用户运行

HTTP 模式认证

SSE 和 Streamable HTTP 模式支持 Bearer Token 认证：

# 启动时指定 API Key
TENCENTOS_MCP_API_KEY=your-secret-key tencentos-mcp-server --transport sse --port 8000

# 或通过命令行参数
tencentos-mcp-server --transport streamable-http --api-key your-secret-key

客户端连接时需要在 HTTP Header 中携带：

Authorization: Bearer your-secret-key

未配置 API Key 时，服务器会显示安全警告但仍可启动（便于开发调试）。

安全建议

| 场景 | 建议 | |------|------| | 本地开发 | 使用 stdio 模式，无需额外安全配置 | | 内网部署 | 使用 SSE/HTTP + API Key，监听 127.0.0.1 | | 公网暴露 | ⚠️ 强烈建议：反向代理 (nginx) + TLS + API Key |

📄 协议

Apache License 2.0

🙏 致谢

Quick Setup
Installation guide for this server

Install Package (if required)

uvx tencentos-mcp-server

Cursor configuration (mcp.json)

{ "mcpServers": { "guoningzhang20-tencentos-mcp-server": { "command": "uvx", "args": [ "tencentos-mcp-server" ] } } }