Mac Resource MCP Server

🛠️ Mac资源管理MCP服务器

一个全面的Mac资源管理MCP（模型上下文协议）服务器，与 Cursor IDE和Claude代码CLI 为了防止端口冲突，管理开发服务器实例，并实时监控系统资源，对关键服务进行高级保护。

✨ 特性

• 🛡️ 受保护服务检测 -永远不要意外杀死Docker、数据库或系统服务
• 🎯 项目意识管理 -独立跟踪多个项目及其端口
• 🔄 会话保持 -存活AI聊天重启并保持项目状态
• 🚫 港口冲突预防 -自动检测和解决端口冲突
• 🔍 实时港口监控 -监控特定端口的更改
• 💻 系统资源监控 -CPU、内存和网络使用情况
• 🧠 智能清理 -保护关键服务的智能开发服务器管理
• 🔗 双平台支持 -在Cursor IDE和Claude Code CLI中无缝工作
• 🍎 Mac优化 -使用本机macOS命令以获得最佳性能

🚀 快速开始

安装

# Clone and install
git clone https://github.com/georgesimbe/mac-resource-mcp-server.git
cd mac-resource-mcp-server
./install.sh

Cursor IDE和Claude Code CLI中的用法

安装后，重新启动Cursor和Claude Desktop（用于Cursor IDE），或确保正确配置了Claude Code CLI。您现在可以使用自然语言：

"Check if port 4321 is available"
"Register my Next.js project on ports 3000 and 3001"
"Kill only development servers, protect my database"
"Show me my active projects"
"Clean up ports for my React project only"
"What services are protected from being killed?"
"Add my custom Redis instance on port 6380 to protected list"

🛠️ 核心工具

港口管理

check_port(port: number)

检查特定端口是否正在使用中，并显示流程详细信息。

例子：

> Check port 3000
🔴 Port 3000 is in use:
  • PID: 12345
  • Process: node
  • Command: npm run dev

kill_port(port: number, force?: boolean)

通过保护检查杀死在特定端口上运行的进程。

保护功能：

• 自动保护数据库服务器（MySQL、PostgreSQL、Redis、MongoDB）
• 防止终止Docker服务
• 阻止系统服务（SSH、HTTP、HTTPS）
• 终止前对关键流程发出警告

list_dev_ports()

检查常用开发端口（3000、3001、4321、5173、8000、8080、8100、9000）的状态。

monitor_port(port: number, duration?: number)

实时监控端口的变化。

🛡️ 保护和安全

list_protected_services()

显示所有无法终止的受保护端口和服务。

例子：

🛡️ Protected Services Configuration:

📋 Protected Ports:
  • Port 22: SSH
  • Port 3306: MySQL
  • Port 5432: PostgreSQL
  • Port 6379: Redis
  • Port 27017: MongoDB
  • Port 2375: Docker daemon (unsecured)
  • Port 2376: Docker daemon (secured)

🔍 Currently Running Protected Services:
  • MySQL on port 3306 ✅
  • Redis on port 6379 ✅

add_protected_port(port: number, service: string)

将自定义端口添加到受保护列表中。

例子：

> Add port 6380 as "Custom Redis Instance"
🛡️ Added port 6380 to protected services as "Custom Redis Instance"

kill_dev_servers_selective()

智能地仅终止开发服务器，同时保护数据库和系统服务。

智能检测：

• 识别和保护Docker容器
• 保留数据库连接
• 维护系统服务
• 仅终止开发服务器

🎯 项目管理

add_project(name: string, directory: string, ports: number[], framework: string)

为会话持久性注册一个项目及其端口。

例子：

> Register "My Next.js App" at "/Users/dev/my-app" using ports [3000, 3001] with Next.js
✅ Added project "My Next.js App" with ports [3000, 3001] using Next.js framework

list_active_projects()

列出所有已注册的活动项目及其端口。

例子：

📋 Active Projects:

🚀 My Next.js App (Next.js)
   📁 /Users/dev/my-app
   🔌 Ports: 3000, 3001
   ⏰ Last active: 12/24/2024, 2:30:15 PM

🚀 Astro Blog (Astro)
   📁 /Users/dev/blog
   🔌 Ports: 4321
   ⏰ Last active: 12/24/2024, 1:45:22 PM

kill_project_ports(project_name: string)

仅终止特定项目的端口，其他项目保持不变。

智能项目清理：

• 仅影响指定项目的端口
• 保护其他项目免受意外终止
• 维护数据库和系统服务连接
• 非常适合AI聊天重启

系统监控

system_resources()

获取当前系统资源使用情况（内存、CPU、网络）。

kill_dev_servers(server_type?: string)

按类型或全部杀死开发服务器。

服务器类型：

• astro -杀死Astro开发服务器
• npm -关闭npm开发服务器
• vite -快速杀死服务器
• next -关闭Next.js服务器
• all -关闭所有开发服务器（默认）

🔄 会话保持

服务器自动维护会话数据 ~/.mac-resource-mcp/session.json:

• 项目注册表 -记住您的活动项目及其端口
• 自定义保护端口 -保留您的自定义保护规则
• 自动清理 -删除24小时以上不活动的项目
• AI聊天弹性 -幸存Claude/Cursor重新启动

🧠 AI聊天重启场景

非常适合您运行多个项目并且AI聊天重新启动的情况：

# Before AI restart - Register your projects
"Register my React app on port 3000 and API on 3001"
"Add my local Redis on port 6380 to protected services"
"Register my Astro blog on port 4321"

# After AI restart - Projects are automatically remembered
"Clean up only my React app ports"  # Only kills 3000, 3001
"Show my active projects"           # Lists all registered projects
"Kill development servers but protect databases"  # Smart cleanup

🔧 手动设置

先决条件

• Node.js 18+
• macOS（针对Mac命令进行了优化）
• 带Claude集成的游标IDE 或 克劳德代码CLI

从源代码构建

# Install dependencies
npm install

# Build TypeScript
npm run build

# Setup Claude Desktop integration
npm run setup-cursor

不同平台的配置

光标IDE（通过克劳德桌面）

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "mac-resource-manager": {
      "command": "node",
      "args": ["/path/to/mac-resource-mcp-server/dist/index.js"]
    }
  }
}

克劳德代码CLI

正确安装后，服务器会自动使用Claude Code CLI。MCP服务器将通过标准MCP协议提供。

有关Claude Code CLI的详细配置，请参阅 claude-code-config.md.

Claude Code CLI的快速设置:

1. 自动：运行 ./install.sh -服务器将自动可用
2. 手册：添加到项目的 CLAUDE.md:

   # MCP Servers
   Server path: `/path/to/mac-resource-mcp-server/dist/index.js`

1. 环境变量:

   export MAC_RESOURCE_MCP_SERVER="node /path/to/mac-resource-mcp-server/dist/index.js"

📋 外壳别名

安装脚本创建了有用的别名：

# Check development ports
dev-ports

# Kill all development servers
kill-dev

# Clean development environment
dev-clean

# Check specific port
port-check 3000

# Kill specific port
port-kill 3000

🔒 安全防护

内置受保护的服务

• 数据库MySQL（3306）、PostgreSQL（5432）、Redis（6379）、MongoDB（27017）
• 码头工人：Docker守护进程（2375，2376），Docker Swarm（2377）
• 系统服务：SSH（22）、HTTP（80）、HTTPS（443）、DNS（53）、SMTP（25）
• 开发数据库：SQL Server（1433）、CouchDB（5984）、Elasticsearch（9200）
• 消息代理：拉比MQ（5672），卡夫卡（9092）

智能过程检测

• 验证端口范围（1-65535）
• 防止杀死系统关键进程
• 默认情况下，使用SIGTERM进行优雅的终止
• 关键服务的流程模式匹配
• 具有会话持久性的自定义保护规则

🐛 故障排除

杀戮后港口仍在使用中

某些进程可能需要时间才能终止。等待几秒钟，然后再次检查。

权限被拒绝错误

确保您有适当的权限来终止进程。某些系统进程需要管理员权限。

受保护的服务警告

如果您收到保护警告，请使用 list_protected_services 看看什么是受保护的，为什么。

会话数据问题

会话数据存储在 ~/.mac-resource-mcp/session.json。删除此文件以重置。

🤝 贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 如果适用，添加测试
5. 提交拉取请求

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🙏 致谢

• 内置于 模型上下文协议SDK
• 针对macOS系统命令进行了优化
• 专为无缝集成Cursor IDE和Claude Code CLI而设计
• 通过AI优先的开发工作流程进行增强

______________________________________________________________________

由以下材料制成❤️ Mac开发社区