How to Build and Debug MCP Servers for Claude Desktop in 5 Seconds 🔨

What is mcp-forge?

mcp-forge gives you everything you need to build, test, inspect, and run MCP servers with zero setup overhead:

• 🛠️ npx mcp-forge serve : Launches a built-in suite of developer tools for Claude Desktop (Git summary, System diagnostics, Mermaid syntax validator, HTTP API tester).
• 🔍 npx mcp-forge inspect <cmd> : An interactive stdio inspector to connect to any MCP server, list tools/resources/prompts, and test executions live.
• ⚡ npx mcp-forge init <name> : Scaffolds a production-ready TypeScript MCP server in 5 seconds with TypeScript, tsup bundler, and Vitest.
• 🌐 npx mcp-forge ui : A visual dark-themed web dashboard for real-time WebSocket traffic monitoring.

Quickstart: Supercharge Claude Desktop in 1 Minute

You don't even need to install anything globally! You can run mcp-forge directly via npx.

1. Add mcp-forge to Claude Desktop
   Add this snippet to your claude_desktop_config.json:

   {
     "mcpServers": {
       "mcp-forge": {
         "command": "npx",
         "args": ["-y", "mcp-forge", "serve"]
       }
     }
   }
   

   Now Claude can automatically inspect your Git status, fetch system memory/CPU telemetry, validate Mermaid diagram syntax, and test REST endpoints!

Scaffold a New MCP Server in 5 Seconds

Want to build your own custom MCP server? Run:

npx mcp-forge init my-awesome-mcp-server
cd my-awesome-mcp-server
npm install
npm run dev

You get a fully-typed MCP server template with @modelcontextprotocol/sdk configured and ready to publish.

Inspect & Debug Any MCP Server in Terminal

Need to test an existing MCP server process? Run the inspector:

npx mcp-forge inspect node ./dist/index.js

mcp-forge will connect to the stdio transport, list all declared tools, prompts, and resources, and allow you to test tool calls directly with live JSON-RPC logging.

Visual Web Dashboard

Prefer a GUI over terminal output? Launch the local web dashboard:

npx mcp-forge ui

Open http://localhost:3000 in your browser to inspect active MCP tools and watch live WebSocket traffic.

Open Source & Contributing

mcp-forge is 100% open-source under the MIT License. We welcome contributions from developers worldwide! Whether you want to add a new built-in tool (e.g., SQLite inspector, Docker manager) or improve the CLI, check out our GitHub repository.

⭐ Check out the project on GitHub: https://github.com/sweecksss/mcp-forge

If you find mcp-forge useful, please leave a ⭐️ Star on GitHub - it helps the project grow! Happy coding! 🚀