Linux MCP Toolkit
Linux MCP Toolkit 是一个基于 MCP 协议的增强型 Linux 管理工具包，提供交互式 SSH 会话、系统监控、文件操作等功能。
🚀 功能特性
- 交互式 SSH 会话：持久化的 SSH 连接，支持实时命令执行
- 系统监控：快速获取系统信息、进程监控、网络状态
- 文件操作：远程文件读写、目录列表、权限管理
- 服务管理：systemd 服务控制（启动、停止、重启、状态检查）
- 跨平台支持：Windows、Linux、macOS 全平台兼容
- MCP 协议：基于 Model Context Protocol 的标准接口
📦 安装
通过 PyPI 安装
pip install linux-mcp-toolkit
从源码安装
git clone https://github.com/linux-mcp/linux-mcp-toolkit.git
cd linux-mcp-toolkit
pip install -e .
🔧 快速开始
基本使用
from linux_mcp_toolkit import ping_host, execute_command, create_interactive_session
# 检查主机连通性
result = ping_host("192.168.1.100")
print(result)
# 执行单个命令
output = execute_command("192.168.1.100", "ls -la /home")
print(output)
# 创建交互式会话
session = create_interactive_session("192.168.1.100", "username", "password")
print(session)
MCP 服务器使用
# 启动 MCP 服务器
python -m linux_mcp_toolkit
🛠️ 工具函数
网络工具
ping_host(host, count=4): 检查主机连通性network_info(ip_address): 获取网络配置信息
系统管理
quick_system_info(ip_address): 快速系统信息monitor_process(ip_address, process_name): 进程监控service_control(ip_address, service, action): 服务管理
文件操作
file_operations(ip_address, operation, path, content=None): 文件读写操作
交互式会话
create_interactive_session(ip_address, username, password, port): 创建会话execute_interactive_command(ip_address, command, timeout=30): 执行命令send_interactive_input(ip_address, input_text): 发送输入get_real_time_output(ip_address, duration=5): 获取实时输出list_active_sessions(): 列出活跃会话close_session(ip_address): 关闭会话
🔐 认证方式
支持两种认证方式：
- 密码认证：使用用户名和密码
- 密钥认证：使用 SSH 私钥
📋 依赖要求
- Python >= 3.8
- paramiko >= 2.7.0 (SSH 客户端)
- mcp >= 1.0.0 (MCP 协议支持)
🐛 问题反馈
如果遇到问题，请通过以下方式反馈：
- GitHub Issues: https://github.com/linux-mcp/linux-mcp-toolkit/issues
- 邮件联系: contact@linuxmcp.com
📄 许可证
MIT License - 详见 LICENSE 文件
🤝 贡献
欢迎提交 Issue 和 Pull Request！
🎯 版本历史
- v1.0.0: 初始版本，包含基本功能
- 交互式 SSH 会话
- 系统监控工具
- 文件操作功能
- 服务管理工具
1 maintainer
Metadata
1 maintainer
Release files for linux-mcp-toolkit 1.0.16
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| linux_mcp_toolkit-1.0.16.tar.gz | 10.8 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| linux_mcp_toolkit-1.0.16-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 20.0 kB
Release files / linux_mcp_toolkit-1.0.16.tar.gz
| Download URL | linux_mcp_toolkit-1.0.16.tar.gz |
|---|---|
| Size | 10.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bd23294a649da9b5c36a7ff53551d93d0eee37d1f85379b20f6337581bddb045
|
|
BLAKE2b-256 checksum How to use checksums |
ae938a67127c7695e5c2b34cd7a2fedcd3ac927dfcbb4b72cd0c2cd15c16282a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.4
|
Release files / linux_mcp_toolkit-1.0.16-py3-none-any.whl
| Download URL | linux_mcp_toolkit-1.0.16-py3-none-any.whl |
|---|---|
| Size | 9.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f506e7e7fce8559660537d347012a1929dba94e4d19b5a8197b01148c70fd2a5
|
|
BLAKE2b-256 checksum How to use checksums |
1ed5921924ee7a0424ed9146a3021b7dde4e731a2d1b754adf23d0dea503ebdb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.4
|
Security for linux-mcp-toolkit 1.0.16
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
