Linux Bash MCP服务器
一个强大的模型上下文协议（MCP）服务器，使Claude Desktop能够在Windows上的任何WSL2 Linux发行版中执行bash命令和脚本。具有通用Linux兼容性、智能分布检测和全面的安全措施。
🚀 快速开始
# 1. Clone the repository
git clone https://github.com/yourusername/linux-bash-mcp-server.git
cd linux-bash-mcp-server
# 2. Run automated setup
npm run fix
# 3. Restart Claude Desktop
# 4. Start using Linux commands in Claude!✨ 特性
- 🐧 通用Linux支持 -适用于Ubuntu、Debian、Fedora、openSUSE、Alpine等
- 🔍 智能配电检测 -自动检测和配置可用的WSL发行版
- 🛡️ 安全配置合并 -设置时保留现有的MCP服务器
- 🔧 综合诊断 -内置故障排除和自动修复工具
- ⚡ 高性能 -通过可配置的超时优化命令执行
- 📊 详细日志记录 -故障排除和监控的调试模式
- 🔄 易于管理 -用于设置、测试和维护的简单脚本
🛠️ 可用工具
| 工具 | 说明 | 示例使用 | |
|---|---|---|---|
execute_bash_command | 运行单个bash命令 | `ps aux \ | grep nginx` |
execute_bash_script | 使用args执行bash脚本 | 运行监控脚本 | |
create_bash_script | 创建新的bash脚本 | 生成自动化脚本 | |
list_directory | 列出目录内容 | 浏览文件系统 | |
get_system_info | 全面的系统信息 | 检查操作系统、内存、磁盘使用情况 | |
check_wsl_status | WSL和分发状态 | 验证连接 |
📋 先决条件
- 安装了WSL2的Windows
- WSL2中的任何Linux发行版 （Ubuntu、Debian等）
- Node.js 18+
- 克劳德桌面应用程序
🎯 安装和设置
选项1：自动设置（推荐）
git clone https://github.com/yourusername/linux-bash-mcp-server.git
cd linux-bash-mcp-server
npm run fix选项2：手动设置
# Install dependencies
npm install
# Run interactive setup
npm run setup
# Test functionality
npm test选项3：快速诊断
# Check for issues
npm run debug
# Verify configuration
npm run check-config⚙️ 配置
服务器会自动检测您的WSL发行版并进行自我配置。手动配置可在 config.json:
{
"wslDistribution": "auto-detect",
"defaultTimeout": 30000,
"scriptTimeout": 60000,
"maxBufferSize": 10485760,
"debugMode": false
}🔧 可用脚本
| 命令 | 描述 |
|---|---|
npm run fix | 自动修复常见问题和设置 |
npm run setup | 交互式配置向导 |
npm run debug | 全面诊断 |
npm run test | 测试所有功能 |
npm run check-config | 验证配置 |
npm start | 启动MCP服务器 |
🐧 支持的Linux发行版
- 乌班图 （最常见）
- Debian
- 菲多拉
- openSUSE
- Alpine Linux
- Kali Linux
- Oracle Linux
- 还有更多。..
💡 使用示例
配置后，在Claude Desktop中使用以下命令：
系统管理
- *“显示我的Linux环境的全面系统信息”*
- *“检查磁盘使用情况和可用空间”*
- *“按CPU使用率排序的运行进程列表”*
文件操作
- *“列出/var/log中的所有文件及其详细信息”*
- *“查找过去24小时内修改的文件”*
- *“在/home中显示目录大小”*
开发任务
- *“检查Docker是否正在运行”*
- *“显示我主目录中存储库的git状态”*
- *“列出已安装的Python包”*
自动化
- *“为我的文档创建备份脚本”*
- *“生成系统监控脚本”*
- *“创建日志轮换脚本”*
🛡️ 安全功能
- 配置保存 -从不覆盖现有的MCP服务器
- 自动备份 -创建损坏配置的备份
- 输入验证 -验证所有命令和参数
- 超时保护 -防止挂起命令
- 错误处理 -全面的错误报告和恢复
🔍 故障排除
快速修复
npm run fix # Auto-resolve common issues
npm run debug # Detailed diagnostics常见问题
WSL未找到
wsl --install
wsl --install -d Ubuntu缺少依赖关系
npm install配置问题
npm run check-config
npm run setup服务器未启动
npm run debug看 故障排除.md 详细的解决方案。
🤝 与其他MCP服务器集成
此服务器与以下服务器无缝协作：
- PowerShell MCP服务器（Windows命令）
- 内存MCP服务器（持久注释）
- 文件MCP服务器（文件操作）
- Git MCP服务器（版本控制）
- 任何其他MCP服务器
📚 项目结构
linux-bash-mcp-server/
├── src/
│ └── index.js # Main MCP server
├── test/
│ └── test.js # Comprehensive tests
├── examples/
│ ├── system_info.sh # Example monitoring script
│ └── file_operations.sh # Example file operations
├── config.json # Server configuration
├── setup.js # Interactive setup
├── debug.js # Diagnostic tool
├── quick-fix.js # Auto-fix utility
├── check-config.js # Configuration checker
└── README.md # This file🔄 版本历史记录
v1.0.0（当前）
- ✅ 通用Linux发行版支持
- ✅ 智能WSL分布检测
- ✅ 安全配置合并
- ✅ 全面的诊断工具
- ✅ 自动修复实用程序
- ✅ 增强的错误处理
- ✅ 调试模式支持
🤝 贡献
欢迎投稿！拜托：
- 分叉存储库
- 创建要素分支
- 进行更改
- 如果适用，添加测试
- 更新文档
- 提交拉取请求
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🆘 支持
- 问题:
- 文档: 维基工程
- 讨论:
🙏 致谢
- Anthropic 对于模型上下文协议
- 微软 WSL2技术
- 开源社区 Linux发行版和工具
______________________________________________________________________
由以下材料制成❤️ 克劳德桌面和Linux社区
⭐ 如果你觉得这个存储库有用，请为其加星！