项目简介

'mcp-server-restart' 是一个基于 Model Context Protocol (MCP) 构建的服务器,专门为 macOS 上的 Claude Desktop 应用程序设计。它通过 MCP 协议向客户端(例如 Claude 本身)暴露功能,使得用户可以通过与 Claude 对话的方式来重启 Claude Desktop 应用。这在某些情况下,例如 MCP 工具安装后需要重启 Claude 才能生效时,非常有用。

主要功能点

  • 状态资源 (Resource):
    • 提供 'claude://status' 资源,允许客户端查询 Claude Desktop 的当前运行状态,包括是否运行中、进程ID (PID) 和时间戳。
  • 重启工具 (Tool):
    • 提供 'restart_claude' 工具,允许客户端安全地重启 Claude Desktop 应用程序。
    • 在重启前会尝试终止已存在的 Claude Desktop 进程。
    • 重启过程中会发送进度通知。

安装步骤

  1. 环境准备: 确保你的 macOS 系统上已经安装了 Node.js 和 npm (或 uv 和 pip,根据你选择的安装方式)。

  2. 安装 'mcp-server-restart': 你可以选择使用 'npm' 或 'uv' (一个更快的包安装工具,如果你的环境中已经安装)。

    • 使用 npm:

      npm install mcp-server-restart
    • 使用 uv 和 pip:

      uv pip install mcp-server-restart

    注意: 你需要确保 'npx' 或 'uvx' 命令在你的系统 PATH 环境变量中,这样 Claude Desktop 才能正确启动 MCP 服务器。 'npx' 通常随 Node.js 一起安装, 'uvx' 则需要单独安装 'uv' 后使用 'uv venv' 创建虚拟环境,并在虚拟环境中安装包。

服务器配置

要让 Claude Desktop 能够使用 'mcp-server-restart' 服务器,你需要编辑 Claude Desktop 的配置文件 '~/Library/Application Support/Claude/claude_desktop_config.json'。

配置信息 (JSON 格式):

将以下 JSON 代码添加到 'claude_desktop_config.json' 文件的 '"mcpServers"' 字段中。

{
  "mcpServers": {
    "mcp-server-restart": {
      "command": "uvx",
      "args": [
        "mcp-server-restart"
      ]
    }
  }
}

或者,如果你希望使用 'npx' (通常用于 npm 包):

{
  "mcpServers": {
    "mcp-server-restart": {
      "command": "npx",
      "args": [
        "mcp-server-restart"
      ]
    }
  }
}
  • 'server name': 'mcp-server-restart' - 服务器的名称,用于在配置文件中标识。
  • 'command': 'uvx' 或 'npx' - 用于启动服务器的命令。 'uvx' 用于运行基于 'uv' 安装的包, 'npx' 用于运行基于 'npm' 安装的包。
  • 'args': '["mcp-server-restart"]' - 传递给 'command' 的参数,这里指定要运行的包名称 'mcp-server-restart'。

基本使用方法

配置完成后,你就可以通过与 Claude Desktop 对话来使用重启功能了。

例如,你可以对 Claude 说:

  • "restart Claude"
  • "请重启 Claude 应用"

Claude Desktop 会调用 'mcp-server-restart' 服务器提供的 'restart_claude' 工具来重启自身。

你也可以询问 Claude 当前状态:

  • 虽然没有直接的 Prompt 示例,但理论上可以通过某种方式(取决于 Claude Desktop 的具体实现)触发对 'claude://status' 资源的读取,例如,如果 Claude Desktop 允许工具调用返回的资源 URI 的读取。

注意: 本服务器仅提供重启 Claude Desktop 的功能,不包含其他 MCP 服务器的通用功能(例如 Prompt 模板管理)。

信息

分类

桌面与硬件