VOOZH about

URL: https://glama.ai/mcp/servers/restforge/restforge-mcp?locale=zh-CN

⇱ @restforge-dev/mcp-server by restforge | Glama

@restforge-dev/mcp-server

RESTForge 框架的 MCP (Model Context Protocol) 服务器。它将 RESTForge 的功能公开给 AI 智能体（Claude Desktop、Cursor、Claude CLI 以及其他 MCP 客户端），以便智能体可以通过自然语言操作 RESTForge，而无需手动调用 CLI 命令。

要求

  • Node.js >= 18

  • npm >= 9

  • 完整设置工作流：PostgreSQL / MySQL / Oracle / SQLite，RESTForge 许可证密钥

Related MCP server: Swagger MCP

安装

npm install -g @restforge-dev/mcp-server

安装完成后，restforge-mcp 命令将在 PATH 中可用。

快速入门

1. 验证安装

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | restforge-mcp

输出应列出 health_*、setup_*、codegen_* 和 runtime_* 域下的 29 个工具。

2. 在 MCP 客户端中注册

Claude CLI（用户范围，适用于所有项目）：

claude mcp add --transport stdio --scope user restforge -- restforge-mcp

Cursor（项目根目录下的 .cursor/mcp.json）：

{
 "mcpServers": {
 "restforge": {
 "command": "restforge-mcp"
 }
 }
}

Claude Desktop (claude_desktop_config.json)：

{
 "mcpServers": {
 "restforge": {
 "command": "restforge-mcp"
 }
 }
}

3. 通过自然语言使用

在您的 AI 客户端聊天中，输入如下提示：

Setup a new RESTForge project at d:/projects/api-test with PostgreSQL on localhost:5432, license XXXX-XXXX-XXXX-XXXX

Generate a CRUD endpoint for the customer table

Run my RESTForge server (the agent generates a launcher script for the user to execute)

智能体将编排适当的工具来端到端地完成请求。

可用工具

按域组织的 29 个工具。AI 智能体通过 MCP 协议调用这些工具；最终用户不直接调用它们。

健康检查域 (1 个工具)

工具

描述

health_ping

MCP 传输冒烟测试。返回 pong + ISO 时间戳 + 服务器版本

设置域 (9 个工具)

工具

描述

setup_create_folder

为 RESTForge 创建一个新的项目文件夹

setup_install_package

通过 npm 将 restforgejs 安装到项目的 node_modules 中

setup_init_config

通过 restforge-cli init 生成骨架配置和示例负载

setup_write_env

写入包含许可证、服务器和数据库设置的 config/db-connection.env

setup_read_env

从 config/db-connection.env 读取当前值

setup_update_env

更新 config/db-connection.env 中的单个字段

setup_validate_config

验证许可证以及与数据库、Redis 和 Kafka 的连接

setup_get_config_schema

获取 db-connection.env 中所有 63 个可用参数的 JSON 模式

setup_get_init_template

获取原始的 db-connection.env 模板内容

代码生成域 (13 个工具)

工具

描述

codegen_list_tables

列出项目数据库中的所有表（实时内省）

codegen_describe_table

描述特定表的列、主键和外键

codegen_generate_payload

从数据库表生成负载 JSON

codegen_validate_payload

验证负载 JSON 结构和约束

codegen_validate_dashboard_payload

验证仪表板负载结构

codegen_diff_payload

对比负载 JSON 与数据库模式的差异

codegen_sync_payload

将负载 JSON 与数据库模式同步

codegen_create_endpoint

从负载规范构建端点模块

codegen_create_dashboard

从负载规范构建仪表板模块

codegen_validate_sql

通过针对实时数据库的 EXPLAIN 验证 SELECT 或 WITH (CTE) SQL 语句

codegen_get_field_validation_catalog

获取字段验证目录（用于确定负载约束）

codegen_get_query_declarative_catalog

获取查询声明式目录（用于确定查询 JSON）

codegen_get_dashboard_catalog

获取仪表板小部件目录（用于确定仪表板配置）

运行时域 (6 个工具)

工具

描述

runtime_detect_project

扫描 src/modules/*.js 以列出项目名称

runtime_detect_config

扫描 config/*.env 以列出可用的配置文件

runtime_validate_preflight

在启动前验证配置 + 检查 PID 文件 + 检查端口可用性

runtime_check_launcher_exists

检查项目根目录中是否存在启动器文件 (server-start.bat/.sh, ecosystem.config.js)

runtime_generate_launcher

生成 server-start.bat/.sh + server-stop.bat/.sh（以及 PM2 模式下的 ecosystem.config.js）

runtime_check_status

检测服务器是否正在运行（主机或 PM2 模式），并可选择进行 HTTP 健康探测

运行时原则：AI 智能体从不直接启动、停止或重启服务器。运行时工具仅生成用户自行执行的启动器脚本，因此运行中的服务器独立于 AI 会话存在。

兼容性

此 MCP 服务器适用于任何支持 stdio 传输的 MCP 客户端，包括但不限于：

  • Claude Desktop

  • Claude CLI (Claude Code)

  • Cursor

  • Windsurf

  • Cline (VS Code 扩展)

  • Continue (VS Code/JetBrains 扩展)

  • Zed

所使用的模型（Claude、GPT、Gemini 等）取决于客户端配置。对于具有成熟工具调用支持的前沿模型，工具选择的准确性最高。

仓库

许可证

MIT — 参见 LICENSE.md。

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/restforge/restforge-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server