mcpField
M
mcp-server-restart

mcp-server-restart

Local
github.com/non-dirtyDeveloper Tools7Updated 99w ago
Repository

About mcp-server-restart

mcp-server-restart is an MCP server for Claude Desktop on Mac. It lets Claude report the app’s status and restart it after MCP tools are installed.

Key features

  1. 01Restart Claude Desktop
  2. 02Check app status, PID, and timestamp
  3. 03Safely relaunch the app
  4. 04Send restart progress notifications

Use cases

  1. 01Restart Claude after installing an MCP server
  2. 02Check whether Claude Desktop is running

MCP support

It exposes the `restart_claude` tool and a `claude://status` resource to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "restart": {
      "command": "npx",
      "args": [
        "-y",
        "@anaisbetts/mcp-installer"
      ]
    }
  }
}
Run commandnpx -y @anaisbetts/mcp-installer

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@anaisbetts/mcp-installer
pypimcp-server-restart

Tools

2

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
namestringYesThe package name of the MCP server
argsarrayNoThe arguments to pass along
envarrayNoThe environment variables to set, delimited by =

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.