关键词

Mac系统信息Conda环境AI助手系统监控本地服务器

MCP My Mac Server 使用说明

项目简介

MCP My Mac Server 是一个轻量级的 MCP (Model Context Protocol) 服务器实现，专为 macOS 用户设计。它允许 AI 助手（如 Claude、Cursor 等 MCP 客户端）访问您 Mac 电脑的实时系统信息和 Conda 环境配置。通过安全地暴露系统数据，该服务器旨在提升 AI 助手在软件优化、问题排查等方面的辅助能力。

主要功能点

  • 系统信息访问: 允许 AI 助手获取 Mac 电脑的硬件规格、系统配置、资源使用情况等详细信息。
  • Conda 环境信息访问: 支持 AI 助手了解当前电脑上的 Conda 安装信息、环境列表以及指定环境中的软件包列表，方便进行 Python 环境分析和管理。
  • 安全可靠: 仅执行经过验证的安全命令 ('system_profiler' 和 'conda')，所有操作都在本地进行，保障数据安全。
  • 轻量级本地API: 以最小的资源开销在本地运行，不影响系统性能。
  • 易于安装和配置: 提供简单的安装步骤，并支持通过标准 MCP 客户端配置进行连接。

安装步骤

  1. 环境准备:

    • 确保您的 Mac 电脑已安装 Python 3.8 或更高版本。
    • 推荐安装 UV 包管理器 (参考 UV installation)，虽然不是必须，但可以简化安装过程。
    • 确保您的 Mac 电脑已安装 Git。

  2. 克隆仓库: 打开终端，执行以下命令克隆 'mcp-my-mac' 仓库到本地：

    git clone https://github.com/zhongmingyuan/mcp-my-mac.git
cd mcp-my-mac

  3. 安装依赖 (可选): 如果您安装了 UV，可以在项目根目录下执行以下命令安装项目依赖（虽然此项目 'setup.py' 中 'install_requires' 为空，但为了后续扩展，建议执行）：

    uv pip install .

    或者使用 pip 安装:

    pip install .

服务器配置

MCP 服务器需要配置在您的 MCP 客户端中。以下分别针对 Claude Desktop 和 Cursor 提供了配置示例。您需要根据您的 MCP 客户端类型进行相应的配置。

[Claude Desktop 配置示例]

在 Claude Desktop 的 MCP 服务器配置文件 (通常是 JSON 格式) 中，添加以下配置信息。请将 '/YOUR_PATH_TO/mcp-my-mac' 替换为您克隆仓库的实际本地路径。

"mcpServers": {
    "mcp-my-mac": {  // 服务器名称，可以自定义
        "command": "uv",  // 启动命令，这里使用 uv (如果使用 pip 安装，可以替换为 python 或 python3)
        "args": [
            "--directory",  // 指定工作目录参数
            "/YOUR_PATH_TO/mcp-my-mac", //  替换为您的 mcp-my-mac 仓库的本地路径
            "run",        // uv 的运行命令
            "-m",         // 运行模块参数
            "mcp_server_my_mac" //  指定要运行的 Python 模块名 (对应 mcp_server_my_mac 包)
        ]
    }
}

[Cursor 配置示例]

在 Cursor 中添加 Tool 时，选择 "command" 类型，并填入以下命令。同样，请将 '/YOUR_PATH_TO/mcp-my-mac' 替换为您克隆仓库的实际本地路径。

uv run --directory /YOUR_PATH_TO/mcp-my-mac mcp_server_my_mac

或者，如果使用 pip 安装，可以尝试使用以下命令，具体取决于您的 Python 环境配置：

python -m mcp_server_my_mac --directory /YOUR_PATH_TO/mcp-my-mac

或

python3 -m mcp_server_my_mac --directory /YOUR_PATH_TO/mcp-my-mac

注意:

  • 请务必将配置中的 '/YOUR_PATH_TO/mcp-my-mac' 替换为 您实际克隆 'mcp-my-mac' 仓库的绝对路径。
  • 'command' 和 'args' 的配置方式可能因 MCP 客户端而异，请参考您使用的 MCP 客户端的官方文档进行配置。
  • 如果您的系统环境中 'python' 或 'python3' 命令可以直接运行 Python，并且 pip 安装的包路径已添加到环境变量中，您也可以尝试直接使用 'python -m mcp_server_my_mac' 或 'python3 -m mcp_server_my_mac' 作为启动命令。

基本使用方法

完成服务器配置后，当您在 Claude Desktop 或 Cursor 等 MCP 客户端中与 AI 助手对话时，如果 AI 助手需要访问您的 Mac 系统信息或 Conda 环境信息来更好地回答问题或提供帮助，它将自动连接到 MCP My Mac Server 并获取所需的信息。您无需手动操作服务器，只需确保服务器配置正确并在 MCP 客户端运行时保持运行即可。

例如，您可以向 Claude 提问： "我的Mac电脑的内存是多少？" 或 "我的Conda环境中安装了哪些Python包？"，如果 Claude Desktop 配置了 MCP My Mac Server，它就能够调用相应的工具获取信息并更准确地回答您的问题。

信息

分类

桌面与硬件

访问项目