内容
# 🔨 mcp-forge
> **模型上下文协议（MCP）服务器的瑞士军刀开发者工具包与检查器**
[](https://www.npmjs.com/package/mcp-forge)
[](LICENSE)
[](CONTRIBUTING.md)
[](https://www.typescriptlang.org/)
[](https://modelcontextprotocol.io)
[](https://glama.ai/mcp/servers/sweecksss/mcp-forge)
```
███╗ ███╗██████╗██████╗ ███████╗██████╗ ██████╗ ██████╗ ███████╗
████╗ ████║██╔════╝██╔══██╗ ██╔════╝██╔══██╗██╔══██╗██╔════╝ ██╔════╝
██╔████╔██║██║ ██████╔╝ █████╗ ██████╔╝██████╔╝██║ ███╗█████╗
██║╚██╔╝██║██║ ██╔═══╝ ██╔══╝ ██╔══██╗██╔══██╗██║ ██║██╔══╝
██║ ╚═╝ ██║╚██████╗██║ ██║ ██║ ██║██║ ██║╚██████╔╝███████╗
╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝ ╚══════╝
```
**`mcp-forge`** 是一款开源、超快的开发者工具包，用于构建、测试、检查和服务 [模型上下文协议（MCP）](https://modelcontextprotocol.io) 服务器。专为 Node.js 和 TypeScript 设计，它与 **Claude Desktop**、**Cursor**、**Windsurf** 和自定义 LLM 工作流无缝连接。
---
## ✨ 功能
- 🛠️ **即时脚手架（`mcp-forge init`）**：在 5 秒内生成一个生产就绪的 TypeScript MCP 服务器，具有完整的类型安全、构建脚本和测试套件。
- 🔍 **交互式 CLI 检查器（`mcp-forge inspect`）**：连接到任何 stdio MCP 服务器进程，检查已声明的 `tools`、`prompts` 和 `resources`，并跟踪 JSON-RPC 流量。
- 🧰 **扩展的内置套件（`mcp-forge serve`）**：
- 🗄️ `sqlite_inspector`：检查模式和执行本地 SQLite 数据库的读取查询。
- 🐳 `docker_status`：检查活动 Docker 容器、状态和日志。
- 📊 `code_metrics`：分析代码库行数、文件数和语言分布。
- 🐙 `git_summary`：Git 仓库状态、分支和提交遥测。
- 💻 `system_diagnostics`：CPU、RAM、正常运行时间和平台遥测。
- 📊 `mermaid_validate`：验证 Mermaid.js 图表语法结构。
- 🌐 `http_tester`：快速 API 请求和头部测试器。
- 🌐 **视觉 Web 仪表盘（`mcp-forge ui`）**：现代暗黑主题 Web 浏览器界面，用于视觉检查和监控 MCP 服务器。
- 🔌 **可扩展的插件生态系统**：简单的架构使开源贡献者可以轻松添加自定义 MCP 工具。
---
## ⚡ 快速入门
无需安装！直接使用 `npx` 运行：
```bash
# 1. 脚手架一个新的 MCP 服务器
npx mcp-forge init my-custom-server
# 2. 检查现有的 MCP 服务器进程
npx mcp-forge inspect node ./dist/index.js
# 3. 为 Claude 启动内置开发者套件
npx mcp-forge serve
# 4. 打开视觉 Web 仪表盘
npx mcp-forge ui
```
---
## 🤖 将 `mcp-forge serve` 连接到 Claude Desktop
在 `claude_desktop_config.json` 中添加以下代码段：
```json
{
"mcpServers": {
"mcp-forge": {
"command": "npx",
"args": ["-y", "mcp-forge", "serve"]
}
}
}
```
现在，Claude 可以自动检查您的 Git 工作区、执行系统诊断、验证 Mermaid 图表和测试 REST 端点！
---
## 🛠️ 命令参考
| 命令 | 描述 |
| :--- | :--- |
| `mcp-forge init [name]` | 在 `./[name]` 中脚手架一个新的 MCP 服务器项目 |
| `mcp-forge inspect <cmd...>` | 检查 stdio MCP 服务器工具、提示、资源 |
| `mcp-forge serve` | 通过 stdio 运行内置的 MCP 开发者服务器 |
| `mcp-forge ui [-p port]` | 启动本地 Web 仪表盘（默认端口 3000） |
---
## 🤝 贡献
我们欢迎来自世界各地的开发者贡献！无论您是添加新的内置 MCP 工具、改进 CLI 检查器还是修复错误，请查看我们的 **[CONTRIBUTING.md](CONTRIBUTING.md)** 指南。
### 开发设置
```bash
# 克隆仓库
git clone https://github.com/sweecksss/mcp-forge.git
cd mcp-forge
# 安装依赖
npm install
# 构建和运行测试
npm run build
npm test
```
---
## 📄 许可证
[MIT 许可证](LICENSE) 2026 mcp-forge 贡献者
