Skip to main content

MCP server for restarting Claude Desktop

Project description

mcp-server-restart

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

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

pip install mcp-server-restart

Configuration

Claude Desktop Integration

Add the following to your Claude Desktop config file:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-restart": {
      "enabled": true,
      "command": "uv",
      "args": [
        "run",
        "python",
        "-m",
        "mcp_server_restart.server"
      ]
    }
  }
}

Development

Setup

  1. Clone the repository
  2. Install dependencies:
uv venv
uv pip install -e ".[dev]"

Testing

Run the test suite:

pytest

License

MIT License - see LICENSE file for details

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_server_restart-0.1.0.tar.gz (14.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_server_restart-0.1.0-py3-none-any.whl (5.3 kB view details)

Uploaded Python 3

File details

Details for the file mcp_server_restart-0.1.0.tar.gz.

File metadata

  • Download URL: mcp_server_restart-0.1.0.tar.gz
  • Upload date:
  • Size: 14.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.0

File hashes

Hashes for mcp_server_restart-0.1.0.tar.gz
Algorithm Hash digest
SHA256 2c7baf87cac4ff9318afe96f748f7de60af9f33b6830df736edeed5de4d2d679
MD5 1f7bcd9b8e56c894ebfe1098e4c8cb32
BLAKE2b-256 3c8a97ee48d83485581b47a0a3cc5e334b6a7ddb0420c902ef29f471b755d30b

See more details on using hashes here.

File details

Details for the file mcp_server_restart-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_server_restart-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5371b3f857ba83ef8240fa34add01ffa852935ed1895d90de86dee2ea2577f10
MD5 4ba98906902663ce58c9ce894da7bbd5
BLAKE2b-256 2bc72c9ad9c3747bb96475742d7b38c929772fa79198b8190568e39901e3dd32

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page