项目简介
'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 进程。
- 重启过程中会发送进度通知。
安装步骤
-
环境准备: 确保你的 macOS 系统上已经安装了 Node.js 和 npm (或 uv 和 pip,根据你选择的安装方式)。
-
安装 '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 模板管理)。
信息
分类
桌面与硬件