MCP Net Optimizer

🌐 NetMCP

基于模型上下文协议的人工智能Linux网络优化

    

将自然语言转化为优化的网络配置

🔴 Live服务器 · 入门指南 · 特性 · 档案 · 建筑 · 工具

______________________________________________________________________

🔴 Live服务器

NetMCP是 生活在生产中 在FastMCP云上！将您的MCP客户端连接到：

https://netmcp.fastmcp.app/mcp

无需安装——只需将您的AI助手指向托管服务器并开始优化。

______________________________________________________________________

🎯 概述

NetMCP是一个 MCP服务器 这使得像Claude这样的人工智能助手能够智能地优化Linux网络性能。它弥合了高级优化目标之间的差距(*“优化我的游戏网络”*)以及低级Linux命令(sysctl, tc, nft).

┌──────────────────┐      ┌──────────────────┐      ┌──────────────────┐
│   AI Assistant   │ MCP  │     NetMCP       │      │   Linux Kernel   │
│   (Claude, etc)  │◄────►│   Server         │─────►│   Network Stack  │
└──────────────────┘      └──────────────────┘      └──────────────────┘
         ▲                         │
         │                         ▼
    Natural Language        29 Config Cards
    "Reduce my latency"     5 Profiles
                            40+ Tools

✨ 为什么选择NetMCP？

______________________________________________________________________

🚀 入门指南

先决条件

• Linux （Ubuntu 20.04+、Debian 11+或类似版本）
• Python 3.10+
• 网络工具： ip, sysctl, tc, nft

安装

git clone https://github.com/SurriyaGokul/mcp-net-optimizer.git
cd mcp-net-optimizer

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

# Enable privileged commands (one-time setup)
./setup_sudo.sh

使用Claude Desktop进行配置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "netmcp": {
      "command": "python",
      "args": ["-m", "server.main"],
      "cwd": "/path/to/mcp-net-optimizer"
    }
  }
}

独立运行

python -m server.main

______________________________________________________________________

⚡ 特性

🎴 29配置卡

Linux网络堆栈的全面覆盖：

• 16个Sysctl卡 --TCP调优、缓冲区、拥塞控制
• 8交通控制卡 --QoS、整形、排队
• 5个防火墙卡 --速率限制、连接跟踪、NAT

🛡️ 企业安全

生产就绪的安全功能：

• 命令分配 --仅执行已批准的二进制文件
• 自动检查点 --每次更改前的快照
• 即时回滚 --一个恢复状态的命令
• 审计日志 --完整的执行历史记录

🔧 40+MCP工具

全面的网络管理：

• 发现 --接口、路由、DNS、延迟测试
• 规划 --类型安全优化计划
• 验证 --执行前的政策执行
• 执行 --带回滚功能的原子应用程序
• 基准测试 --性能比较前后

🔐 Sudo管理

灵活的权限升级：

• 无密码设置 --快跑 ./setup_sudo.sh 一次
• 缓存凭据 --身份验证一次，缓存15分钟
• MCP工具 — check_sudo_access, request_sudo_access
• 缺省安全 --仅分配命令

______________________________________________________________________

🎮 优化配置文件

针对特定工作负载优化的五个研究支持配置文件：

示例：游戏优化

plan = {
    "iface": "eth0",
    "profile": "gaming",
    "changes": {
        "sysctl": {
            "net.ipv4.tcp_congestion_control": "bbr",
            "net.ipv4.tcp_low_latency": "1",
            "net.core.default_qdisc": "fq"
        },
        "qdisc": {"type": "fq"}
    }
}

______________________________________________________________________

🏗️ 建筑

管道流量

  DISCOVER          PLAN            VALIDATE         RENDER           APPLY
 ┌─────────┐    ┌─────────┐      ┌─────────┐     ┌─────────┐     ┌─────────┐
 │ Inspect │───►│ Declare │─────►│ Check   │────►│Generate │────►│ Execute │
 │ System  │    │ Intent  │      │ Policies│     │Commands │     │ Safely  │
 └─────────┘    └─────────┘      └─────────┘     └─────────┘     └─────────┘
      │              │                │               │               │
   30+ tools    Pydantic         Policy YAML      sysctl/tc/     Checkpoint
   No side      schemas          validation       nft scripts    + Rollback
   effects

项目结构

mcp-net-optimizer/
├── server/
│   ├── main.py              # MCP server entry point
│   ├── registry.py          # Tool & resource registration
│   ├── schema/models.py     # Pydantic data models
│   └── tools/
│       ├── discovery.py     # 30+ system inspection tools
│       ├── planner.py       # Plan → Commands renderer
│       ├── validator.py     # Policy validation
│       ├── validation_engine.py  # Before/after comparison
│       ├── validation_metrics.py # Network benchmarks
│       ├── audit_log.py     # Execution logging
│       ├── apply/           # Command executors
│       │   ├── apply.py     # Orchestration + rollback
│       │   ├── checkpoints.py
│       │   ├── sysctl.py
│       │   ├── tc.py
│       │   └── nft.py
│       └── util/
│           ├── shell.py     # Safe command execution
│           └── policy_loader.py
├── policy/
│   ├── config_cards/        # 29 YAML card definitions
│   ├── profiles.yaml        # 5 optimization profiles
│   └── validation_limits.yaml
└── setup_sudo.sh            # Passwordless sudo setup

______________________________________________________________________

🔧 MCP工具

发现（无副作用）

规划与验证

执行与安全

权限管理

______________________________________________________________________

📊 基准测试与验证

NetMCP包括一个完整的验证管道，用于衡量优化影响：

# 1. Run baseline benchmark
before = test_network_performance_tool(profile="gaming")

# 2. Apply optimizations
apply_rendered_plan_tool(rendered_plan)

# 3. Run post-optimization benchmark  
after = test_network_performance_tool(profile="gaming")

# 4. Compare and validate
result = validate_configuration_changes_tool(before, after, "gaming")
# → {"decision": "KEEP", "score": 75, "summary": "Latency improved 15%"}

验证决策

______________________________________________________________________

🔒 安全模型

命令允许列表

只有明确批准的二进制文件才能执行：

# server/config/allowlist.yaml
binaries:
  - /usr/sbin/sysctl
  - /usr/sbin/tc
  - /usr/sbin/nft
  - /usr/bin/ping
  - /usr/bin/iperf3
  # ... etc

权限提升

sudo访问的三个选项：

1. 永久的 （推荐）：跑步 ./setup_sudo.sh --仅为网络命令配置无密码sudo
2. 基于会话：使用 request_sudo_access_tool(password="...") --缓存15分钟
3. 手册：运行 sudo -v 使用MCP前在终端

______________________________________________________________________

📈 性能结果

通过配置文件衡量的现实世界改进：

______________________________________________________________________

🤝 贡献

欢迎投稿！感兴趣的领域：

• 附加配置卡
• 新的优化配置文件
• 与跨平台支持
• 性能基准
• 文档改进

______________________________________________________________________

📄 许可证

MIT许可证——见 许可证 了解详情。

______________________________________________________________________

内置于❤️ 面向人工智能原生网络的未来