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.1.tar.gz (15.0 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.1-py3-none-any.whl (5.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mcp_server_restart-0.1.1.tar.gz
  • Upload date:
  • Size: 15.0 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.1.tar.gz
Algorithm Hash digest
SHA256 4124a8ba96ade42cc7077e9694e24a33be3cf143bb2026e7da7316ae160df459
MD5 2789007280229f885558133d3e1fbbb3
BLAKE2b-256 1ea994bbfcd1ac97ad5195b8240fd0da7333714f70c13f07dd23426a61935f03

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mcp_server_restart-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c59439a0fea6ae3cef0f2adbdb9b9debce4a1a9cec803269eddab6e017546f3b
MD5 60179a07847b12f6ef55a48e8a50c094
BLAKE2b-256 ac3b13d4770d09d17db7caa8f765321c3a98c5826992e4aeb81d28ead22f4527

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