Vladislav Todorese

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

Model Context Protocol (MCP) by Anthropic is rapidly becoming the open standard for connecting LLMs like Claude Desktop, Cursor, and Windsurf to local dev tools, APIs, and databases.

However, setting up an MCP server from scratch, configuring stdio transports, and debugging JSON-RPC requests in the terminal can be tedious.

To solve this, I built mcp-forge — an open-source Swiss-Army developer toolkit and inspector for MCP servers.

⚡ What is mcp-forge?

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

  1. 🛠️ 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).
  2. 🔍 npx mcp-forge inspect <cmd>: An interactive stdio inspector to connect to any MCP server, list tools/resources/prompts, and test executions live.
  3. ⚡ npx mcp-forge init <name>: Scaffolds a production-ready TypeScript MCP server in 5 seconds with TypeScript, tsup bundler, and Vitest.
  4. 🌐 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"]
    }
  }
}

Enter fullscreen mode Exit fullscreen mode

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

  1. 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

Enter fullscreen mode Exit fullscreen mode

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

  1. 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! 🚀