Linux系统控制协议服务器

一个提供全面系统级访问和控制的强大服务器,支持进程管理、文件系统操作、软件包管理和网络检查等功能。

  • by Praveens1234
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Praveens1234/mcp-server-root

使用说明

Proot发行版ubuntu Linux MCP-

一个强大的模型上下文协议(MCP)服务器,提供全面的系统级访问和控制。该服务器充当Linux系统的“上帝模式”接口,提供进程管理、文件系统操作、包管理和网络检查工具。

特性

  • 流程管理:启动、停止和监视后台任务
  • 壳牌执行:以完全系统访问权限运行阻止命令
  • 文件系统操作:读取、写入、搜索和管理文件和目录
  • 终端会话管理:创建和控制tmux会话
  • 包管理:安装、删除和更新系统软件包
  • 网络检查:分析网络连接和DNS解析

先决条件

  • Python 3.8或更高版本
  • 基于Linux的操作系统(在Ubuntu、Debian、Alpine、Fedora、Arch Linux上测试)
  • 适当的系统权限(某些工具需要sudo/root访问权限)

安装

  1. 克隆存储库:
git clone https://github.com/Praveens1234/mcp-server-root.git
cd mcp-server-root
  1. 安装依赖项:
pip install -r requirements.txt

配置

默认情况下,服务器在端口8000上运行。要更改此设置,请在 server.py 文件。

用法

  1. 启动服务器:
python server.py
  1. 将您的MCP客户端连接到:
http://localhost:8000/sse

可用工具

进程管理器

  • start:启动后台作业
  • check_status:检查正在运行的作业的状态
  • stop:停止正在运行的作业
  • list_jobs:列出所有跟踪的作业
  • read_global_history:阅读全局执行历史记录

壳牌执行人

  • shell_execute:运行快速阻止命令

文件系统

  • read:读取文件内容
  • write:将内容写入文件
  • list:列出目录内容
  • delete:删除文件或目录
  • search:搜索文件
  • mkdir:创建目录

Tmux经理

  • create:创建新的tmux会话
  • kill:终止tmux会话
  • list:列出所有tmux会话
  • send:向tmux会话发送命令
  • read:阅读tmux会话的内容

包管理器

  • install:安装系统包
  • remove:删除系统包
  • update:更新包列表

网络检查员

  • my_ip:显示网络接口信息
  • ping:Ping目标主机
  • curl:执行HTTP请求
  • dns:执行DNS查找

安全考虑

⚠️ 警告:此服务器提供对底层系统的无限制访问。仅在受信任的环境中运行此操作,并确保有适当的访问控制。

  • 未经身份验证,切勿将此服务器暴露于公共网络
  • 使用适当的防火墙规则限制访问
  • 尽可能以最低权限运行
  • 定期审核日志以发现可疑活动

贡献

  1. 克隆该仓库
  2. 创建要素分支
  3. 提交您的更改
  4. 推到分支
  5. 创建拉取请求

许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。