🔨 mcp-forge

The Swiss-Army Developer Toolkit & Inspector for Model Context Protocol (MCP) Servers

NPM Version License: MIT PRs Welcome TypeScript MCP Approved sweecksss/mcp-forge MCP server

   ███╗   ███╗██████╗██████╗     ███████╗██████╗ ██████╗  ██████╗ ███████╗
   ████╗ ████║██╔════╝██╔══██╗    ██╔════╝██╔══██╗██╔══██╗██╔════╝ ██╔════╝
   ██╔████╔██║██║     ██████╔╝    █████╗  ██████╔╝██████╔╝██║  ███╗█████╗  
   ██║╚██╔╝██║██║     ██╔═══╝     ██╔══╝  ██╔══██╗██╔══██╗██║   ██║██╔══╝  
   ██║ ╚═╝ ██║╚██████╗██║         ██║     ██║  ██║██║  ██║╚██████╔╝███████╗
   ╚═╝     ╚═╝ ╚═════╝╚═╝         ╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝

mcp-forge is an open-source, ultra-fast developer toolkit for building, testing, inspecting, and serving Model Context Protocol (MCP) servers. Designed for Node.js & TypeScript, it seamlessly connects with Claude Desktop, Cursor, Windsurf, and custom LLM workflows.

✨ Features

🛠️ Instant Scaffolding (mcp-forge init): Generate a production-ready TypeScript MCP server with full type safety, build scripts, and test suite in 5 seconds.
🔍 Interactive CLI Inspector (mcp-forge inspect): Connect to any stdio MCP server process, inspect declared tools, prompts, and resources, and trace JSON-RPC traffic.
🧰 Expanded Built-in Suite (mcp-forge serve):
- 🗄️ sqlite_inspector: Inspect schemas & execute read queries on local SQLite databases.
- 🐳 docker_status: Inspect active Docker containers, statuses, and logs.
- 📊 code_metrics: Analyze codebase line count (LOC), file counts, and language breakdown.
- 🐙 git_summary: Git repository status, branch, and commit telemetry.
- 💻 system_diagnostics: CPU, RAM, uptime, and platform telemetry.
- 📊 mermaid_validate: Validate Mermaid.js diagram syntax structure.
- 🌐 http_tester: Fast API request & header tester.
🌐 Visual Web Dashboard (mcp-forge ui): Modern dark-themed web browser interface to inspect and monitor MCP servers visually.
🔌 Extensible Plugin Ecosystem: Simple architecture making it easy for open-source contributors to add custom MCP tools.

⚡ Quickstart

No installation required! Run directly using npx:

# 1. Scaffold a new MCP server
npx mcp-forge init my-custom-server

# 2. Inspect any existing MCP server process
npx mcp-forge inspect node ./dist/index.js

# 3. Launch built-in developer suite for Claude
npx mcp-forge serve

# 4. Open visual Web Dashboard
npx mcp-forge ui

🤖 Connecting `mcp-forge serve` to Claude Desktop

Add the following snippet to your claude_desktop_config.json:

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

Now Claude can inspect your Git workspace, perform system diagnostics, validate Mermaid charts, and test REST endpoints automatically!

🛠️ Commands Reference

Command	Description
`mcp-forge init [name]`	Scaffolds a new MCP server project in `./[name]`
`mcp-forge inspect <cmd...>`	Inspects stdio MCP server tools, prompts, resources
`mcp-forge serve`	Runs the built-in MCP developer server via stdio
`mcp-forge ui [-p port]`	Launches local web dashboard (default port 3000)

🤝 Contributing

We welcome contributions from developers worldwide! Whether you want to add a new built-in MCP tool, improve the CLI inspector, or fix bugs, check out our CONTRIBUTING.md guide.

Development Setup

# Clone the repository
git clone https://github.com/sweecksss/mcp-forge.git
cd mcp-forge

# Install dependencies
npm install

# Build & run tests
npm run build
npm test