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

Uploaded Python 3

File details

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

File metadata

  • Download URL: mcp_server_restart-0.1.2.tar.gz
  • Upload date:
  • Size: 14.9 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.2.tar.gz
Algorithm Hash digest
SHA256 857247eacca4ea17d9d7d85f95da6ed743d0a56ce6e427c1bac423eecbf784e4
MD5 18cd54165d1482d8566fd0365747a23d
BLAKE2b-256 1591db80a837138728eb53c964a1b76c406d3d2793bc671c7ed2fc475689f2fb

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mcp_server_restart-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b50f3c858c919f9fd02ee38d660a68235a0d0ed8a63118ec51df4869fea9d05d
MD5 a427edeaa126cda06a90d1cd762096f4
BLAKE2b-256 53cc25f9e386bf5621fd0cd23ba02693da65a7bb957e41af5dd804d499fbff08

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