mcp-server-restart

by non-dirty

758 downloads Not rated yet
GitHub

About

Restarts Claude Desktop after mcp-server installation

Explore

- 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

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

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"
      ]
    }
  }
}

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

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

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"
        ]
    }
}

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.