mcp-server-restart

by non-dirty

758 downloads
Not rated
GitHub

About

Restarts Claude Desktop after mcp-server installation

Details

Author
non-dirty
Downloads
758
Categories
Other

- Provides a restart_claude tool to restart Claude Desktop safely.
- Offers a claude://status resource returning JSON (status, PID, timestamp).
- Safely terminates any existing Claude process before launching a new instance.
- Sends progress notifications during the restart sequence.
- Works alongside the mcp-installer for a seamless tool‑installation workflow.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name mcp-server-restart
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install by adding the server to the Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json) using uvx. Then ask Claude Desktop “restart Claude” and the server will restart the application. Optionally, install mcp-installer alongside it to enable Claude to install other tools before restarting.

install_repo_mcp_server

Install an MCP server via npx or uvx

install_local_mcp_server

Install an MCP server whose code is cloned locally on your computer

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp-server-restart": {
            "mcp-installer": {
                "command": "npx",
                "args": [
                    "@anaisbetts/mcp-installer"
                ]
            },
            "mcp-server-restart": {
                "command": "uvx",
                "args": [
                    "mcp-server-restart"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-installer": {
        "command": "npx",
        "args": [
            "@anaisbetts/mcp-installer"
        ]
    },
    "mcp-server-restart": {
        "command": "uvx",
        "args": [
            "mcp-server-restart"
        ]
    }
}

mcp-server-restart

Model Context Protocol (MCP) server for restarting Claude Desktop for Mac

Description

Using Model Context Protocol (MCP) for Claude Desktop tool installation is a bit cumbersome. The mcp-installer makes things easier by using MCP to allow you to ask Claude to install MCP tools.

Once they are installed, you still need to restart Claude Desktop to make the changes take effect... That is where mcp-server-restart comes in!

The mcp-server-restart package provides a MCP server for restarting Claude Desktop for Mac.

Usage

Ask Claude Desktop "restart Claude" and it will restart the application.

Features

Resources

The server provides a status resource:
- claude://status - Returns the current status of Claude Desktop
- Returns JSON with running status, PID, and timestamp
- MIME type: application/json

Tools

The server implements one tool:
- restart_claude - Restarts the Claude Desktop application
- Safely terminates existing process if running
- Launches new instance
- Provides progress notifications during restart

Installation for Claude Desktop

Installation requires editing your Claude Desktop config file on MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Option 1: Install both the mcp-installer and the mcp-server-restart packages:

Add the following to your Claude Desktop config file:

{
  "mcpServers": {
    "mcp-installer": {
      "command": "npx",
      "args": [
        "@anaisbetts/mcp-installer"
      ]
    },
    "mcp-server-restart": {
      "command": "uvx",
      "args": [
        "mcp-server-restart"
      ]
    }
  }
}

Option 1: Install only the mcp-server-restart package:

Add the following to your Claude Desktop config file:

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

Example prompts

> Hey Claude, install the MCP server named mcp-server-fetch then restart Claude

> Please restart Claude

Testing

Run the test suite:

pytest

License

MIT License - see LICENSE file for details

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.