de en es ja ko ru zh

@restforge-dev/mcp-server

RESTForge 프레임워크를 위한 MCP(Model Context Protocol) 서버입니다. RESTForge 기능을 AI 에이전트(Claude Desktop, Cursor, Claude CLI 및 기타 MCP 클라이언트)에 노출하여, 사용자가 CLI 명령어를 수동으로 실행할 필요 없이 자연어로 RESTForge를 운영할 수 있게 합니다.

요구 사항

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 클라이언트 채팅창에 다음과 같이 입력하세요:

PostgreSQL을 사용하여 d:/projects/api-test에 새로운 RESTForge 프로젝트를 설정하고, localhost:5432에서 라이선스 XXXX-XXXX-XXXX-XXXX를 사용해줘

customer 테이블에 대한 CRUD 엔드포인트를 생성해줘

RESTForge 서버를 실행해줘 (에이전트가 사용자가 실행할 수 있는 런처 스크립트를 생성합니다)

에이전트는 요청을 완벽하게 처리하기 위해 적절한 도구들을 조정합니다.

사용 가능한 도구

도메인별로 구성된 29개의 도구입니다. AI 에이전트가 MCP 프로토콜을 통해 이를 호출하며, 최종 사용자가 직접 호출하지는 않습니다.

Health 도메인 (1개 도구)

도구	설명
`health_ping`	MCP 전송 스모크 테스트. `pong` + ISO 타임스탬프 + 서버 버전을 반환합니다

Setup 도메인 (9개 도구)

도구	설명
`setup_create_folder`	RESTForge를 위한 새 프로젝트 폴더 생성
`setup_install_package`	npm을 통해 프로젝트의 `node_modules`에 `restforgejs` 설치
`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` 템플릿 콘텐츠 가져오기

Codegen 도메인 (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`	대시보드 위젯 카탈로그 가져오기 (대시보드 구성 근거용)

Runtime 도메인 (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`	선택적 HTTP 상태 프로브를 사용하여 서버 실행 여부 감지 (호스트 또는 PM2 모드)

런타임 원칙: AI 에이전트는 서버를 직접 시작, 중지 또는 재시작하지 않습니다. 런타임 도구는 사용자가 직접 실행할 수 있는 런처 스크립트만 생성하므로, 실행 중인 서버는 AI 세션과 독립적으로 유지됩니다.

호환성

이 MCP 서버는 stdio 전송을 지원하는 모든 MCP 클라이언트와 호환되며, 다음을 포함합니다:

Claude Desktop
Claude CLI (Claude Code)
Cursor
Windsurf
Cline (VS Code 확장 프로그램)
Continue (VS Code/JetBrains 확장 프로그램)
Zed

사용되는 모델(Claude, GPT, Gemini 등)은 클라이언트 구성에 따라 다릅니다. 도구 호출 정확도는 도구 호출 지원이 성숙한 최신 모델에서 가장 좋습니다.

저장소

소스: https://github.com/restforge/restforge-mcp
이슈: https://github.com/restforge/restforge-mcp/issues

라이선스

MIT — LICENSE.md를 참조하세요.

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

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

URL: https://glama.ai/mcp/servers/restforge/restforge-mcp?locale=ko-KR