godmode_mcp

MCP Server – Model Context Protocol for Local Command Execution

A lightweight MCP (Model Context Protocol) server that enables local command execution through LLMs such as Claude Desktop. It allows LLMs to seamlessly perform coding tasks like generating files, launching projects, opening editors, and more.

🚀 Features

• ✅ Execute shell commands through LLM interfaces
• 🧠 Integrates with Claude Desktop (or similar LLMs)
• 🛠️ Enables full project scaffolding (e.g., React + Vite apps)
• 🧪 Tested with tasks like:
  • Creating a Todo app using React + Vite
  • Opening the project in VS Code
  • Running the development server locally

⚙️ Requirements

Install Claude Desktop and recomend using uv:

• Install uv by running pip install uv
• Run uv init my-first-mcp-server to create a project directory
• Run uv add "mcp[cli]" to add mcp cli in your project
• Few folks may get type errors for which you can run pip install --upgrade typer to upgrade typer library to its latest version
• Install this server inside Claude desktop by running uv run mcp install main.py in the project directory
• Kill any running instance of Claude from Task Manager. Restart Claude Desktop
• In Claude desktop, now you will see tools from this server

🧠 How It Works

1. The LLM sends a request with a task or command
2. MCP Server parses and safely executes it locally
3. Output is returned to the LLM for further reasoning or action

⚠️ Be extremely careful when enabling command execution from external sources. For now i have added a BASE_DIR which will be default working directory for comands.

🔧 Example Use Case

# Register MCP Server
uv run mcp install main.py

Then, from your LLM (e.g., Claude Desktop), send:

"Create a React + Vite app named todo-app, open it in VS Code, and launch it."

✅ The server will:

• Run npm create vite@latest todo-app
• Navigate into the folder
• Run npm install
• Launch VS Code and dev server