🖥️ 本地MCP服务器
 ](https://nodejs.org/)  
A. 模型上下文协议（MCP）服务器 专为macOS开发人员设计。该服务器提供全面的系统监控、诊断和实用工具，可与MCP兼容的客户端无缝集成，如 克莱恩.
✨ 主要特点
🔧 系统工具
- 🛡️ 安全命令执行：运行带有内置安全检查的shell命令，以防止破坏性操作
- 📁 目录列表：使用高级筛选选项浏览下载、桌面和文档
- 🔍 智能过滤：按年龄、大小和递归目录遍历筛选文件
📊 系统监控
- 💻 系统信息：全面的系统统计数据（CPU、内存、正常运行时间、平均负载）
- ⚡ 过程监控：通过CPU/内存使用和智能过滤进行实时进程跟踪
- 🌐 端口扫描器：识别开放端口和使用它们的流程
- 💾 磁盘使用情况分析：开发目录的详细磁盘空间分析
- 📡 网络诊断：用于连接测试的Ping、traceroute和DNS查找工具
🛡️ 安全与安保
- 危险指挥保护：自动阻止可能具有破坏性的命令
- 智能命令分析：警告需要提升权限的命令
- 综合安全模式：防止文件系统损坏、系统关闭和安全隐患
🚀 安装和设置
先决条件
- Node.js （v16或更高版本）
- npm 或 纱线
- macOS （针对macOS系统命令进行了优化）
快速开始
- 克隆并安装依赖项:
git clone
cd local_mcp
npm install- 构建项目:
npm run build- 以开发模式运行:
npm run dev- 启动生产服务器:
npm start🔧 配置
添加到MCP客户端（例如Cline）
将此服务器添加到MCP配置文件中：
{
"mcpServers": {
"local-mcp": {
"command": "node",
"args": ["/path/to/local_mcp/dist/index.js"],
"env": {}
}
}
}🎯 如何使用MCP客户端
🧹 “我的下载文件夹是一个灾难区域”
请Cline帮助您清理下载文件夹。它可以找到所有那些弄乱你下载的旧文件，识别占用你存储空间的大量文件，并安全地帮助你删除或组织它们。不再需要手动搜索数百个随机下载！
🚀 “我的MacBook听起来像喷气发动机”
当你的Mac运行得又热又吵时，让Cline找出导致CPU使用率高的原因。它可以找到CPU消耗量最大的进程，帮助您了解它们是什么，并建议减少负载的方法——无论是杀死失控的Chrome标签页还是优化资源密集型应用程序。
🕳️ “我的磁盘空间都去哪儿了？”
让Cline搜索你的存储，吃掉目录和文件。它可以分析您的整个系统，找出占用空间最大的部分，识别带有大量node_modules的被遗忘的项目文件夹，并通过清理旧的构建工件来帮助您回收千兆字节的空间。
🌐 “为什么我的API不能连接？”
当你的应用程序无法访问API时，Cline可以帮助诊断问题。它可以测试网络连接，检查DNS解析，跟踪数据包路由以确定连接失败的位置，并帮助您了解问题是本地还是远程的。
🔍 “有什么东西占据了3000号港口”
尝试启动开发服务器时遇到端口冲突？让Cline确定什么在使用你的端口。它可以找到阻塞您端口的确切进程，并帮助您杀死它或将服务器移动到其他端口。
📱 “我的系统在构建过程中感觉迟钝”
当您的Mac在构建或部署等繁重操作中变得无响应时，Cline可以实时监控您的系统资源，识别内存消耗大的进程，并建议优化以保持系统响应。
🏠 “桌面春季清洁时间”
让Cline帮助您整理桌面混乱。它可以找到旧的屏幕截图，识别意外保存到桌面的大文件，并帮助您将所有内容移动到适当的文件夹或存档位置。
🔧 “我的发展环境健康吗？”
在开始一个大型的编码会话之前，让Cline进行一次快速的健康检查。它可以验证您的系统资源是否充足，检查是否有任何开发服务器正在运行，并确保您与基本服务的网络连接正常工作。
🗂️ “我需要审核我的项目文件”
计划归档旧项目？Cline可以递归扫描您的项目目录，确定哪些目录几个月来没有被触及，计算存储使用情况，并帮助您就保留或存档什么做出明智的决定。
⚡ “我的构建过程出奇地慢”
当构建耗时很长时，Cline可以帮助诊断瓶颈。它可以在构建过程中监控资源使用情况，确定是否内存不足，检查竞争进程，并建议系统优化。
🏗️ 项目结构
local_mcp/
├── 📁 src/
│ ├── 📄 index.ts # Main MCP server class & request handling
│ ├── 📄 tools.ts # Tool registry and exports
│ ├── 📄 system-monitor.ts # System monitoring tools & handlers
│ ├── 📄 system-utilities.ts # Utility tools & safety mechanisms
│ └── 📄 handlers.ts # Legacy handler implementations
├── 📁 test/ # Comprehensive test suite
├── 📁 dist/ # Compiled JavaScript output
├── 📄 package.json # Dependencies and scripts
├── 📄 tsconfig.json # TypeScript configuration
├── 📄 jest.config.js # Test configuration
└── 📄 mcp-config.json # Sample MCP configuration🧪 开发与测试
可用脚本
# Development
npm run dev # Run with hot reload using nodemon
npm run build # Compile TypeScript to JavaScript
npm run start # Run production build
# Testing
npm test # Run test suite
npm run test:watch # Run tests in watch mode
npm run test:coverage # Run tests with coverage report
npm run test:verbose # Run tests with detailed output
# Maintenance
npm run clean # Remove compiled files
npm run build:full # Clean and rebuild
npm run verify # Run tests and build (CI pipeline)运行测试
该项目包括全面的测试覆盖范围：
# Run all tests with coverage
npm run test:coverage
# Watch mode for development
npm run test:watch🛡️ 安全功能
指挥安全系统
这 run_command 该工具包括复杂的安全机制：
❌ 已阻止的命令 （自动预防）
- 文件系统销毁:
rm -rf /,dd if=/dev/zero - 系统控制:
shutdown,reboot,halt - 安全旁路:
chmod 777 /,iptables -F - 流程中断:
killall -9,kill -9 1 - 磁盘操作：写信给
/dev/sda,mkfs.*
⚠️ 警告命令 （带警告执行）
- 权限提升:
sudo,su - 文件权限:
chmod,chown - 文件操作:
rm,mv到系统目录
使用示例
// ✅ Safe command - executes normally
run_command({ command: "ls -la" })
// ⚠️ Caution command - executes with warning
run_command({ command: "sudo npm install -g some-package" })
// ❌ Dangerous command - blocked completely
run_command({ command: "rm -rf /" })
// Returns: "🚨 COMMAND BLOCKED FOR SAFETY 🚨"🤝 贡献
欢迎投稿！请随时提交拉取请求。
开发指南
- 遵循TypeScript的最佳实践
- 为新功能编写测试
- 使用有意义的提交消息
- 更新新工具的文档
添加新工具
- 定义工具模式 在适当的文件中(
system-monitor.ts或system-utilities.ts) - 实现处理程序方法 在同一个文件中
- 添加开关盒 在
src/index.ts - 编写全面的测试
- 更新README文档
🐛 故障排除
常见问题
权限错误
# Ensure proper file permissions
chmod +x dist/index.js端口已在使用中
# Use port scanner to identify conflicts
port_scanner({ port_range: "3000" })内存问题
# Monitor system resources
system_info({ detailed: true })
process_monitor({ sort_by: "memory", limit: 10 })📄 许可证
ISC许可证-请参阅 许可证 文件以获取详细信息。
� 相关项目
______________________________________________________________________
Made with ❤️ for macOS developers