1. Conduid
  2. Documentation
  3. Restful To MCP
MCP server · Documentation

Restful To MCP

· github.com/lengyue1084/restful-to-mcp

将现有 RESTful API 快速转换为 MCP (Model Context Protocol) 服务，让 AI 大模型直接调用你的 API。支持 OpenAPI 文档自动解析和表单手动创建两种方式。

Unclaimed docs
InstallView source
34Low

Scored 6 months ago · breakdown

About Restful To MCP

Restful To MCP is an MCP server in the Documentation category: 将现有 RESTful API 快速转换为 MCP (Model Context Protocol) 服务，让 AI 大模型直接调用你的 API。支持 OpenAPI 文档自动解析和表单手动创建两种方式。.

Install

From source
git clone https://github.com/lengyue1084/restful-to-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Restful To MCP

Powered by Claude · Grounded in docs

I know everything about Restful To MCP. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

RESTful-to-MCP

English | 中文

Turn existing RESTful APIs into MCP (Model Context Protocol) servers so AI clients can call your APIs through a standard MCP gateway.

Features

  • Import Swagger 2.0 / OpenAPI 3.x documents and generate MCP servers and tools automatically.
  • Create MCP servers and tools manually from the management UI.
  • Expose a unified MCP gateway at /gateway/:serverToken/mcp.
  • Support tool testing, authentication settings, and server detail inspection in the frontend.
  • Support PostgreSQL / MySQL and Redis.
  • Optional Nacos service registration.

Screenshots

Server List

MCP Server List

Server Detail

MCP Server Detail

Tool Detail

MCP Server Tool Detail

OpenAPI Import

OpenAPI Import

API Test Example

Postman Test

Architecture

RESTful API / OpenAPI
        |
        v
RESTful-to-MCP Management API (/v1/...)
        |
        +--> OpenAPI parser / manual form configuration
        |
        +--> MCP server + tool registry
        |
        v
MCP Gateway (/gateway/:serverToken/mcp)
        |
        v
MCP clients (Claude Desktop, Cursor, Cherry Studio, etc.)

Quick Start

Requirements

  • Go 1.24+
  • PostgreSQL 14+ or MySQL 8+
  • Redis 7+

Run Locally

git clone https://github.com/lengyue1084/restful-to-mcp.git
cd restful-to-mcp

cp configs/config.yaml.example configs/config.yaml
# edit configs/config.yaml

go install github.com/google/wire/cmd/wire@latest
make wire
make run

Default backend address:

http://localhost:9002

Frontend

The repository also contains a React + Vite frontend in web/.

cd web
npm install
npm run dev

Default frontend address:

http://localhost:3000

MCP Usage

The gateway endpoint is:

POST /gateway/:serverToken/mcp

serverToken now supports both:

  • server UUID
  • generated connectToken

Important:

  • Do not open the MCP endpoint directly in a browser.
  • The MCP gateway expects POST JSON-RPC requests.
  • A browser GET request will usually return 404.

Example tools/list request:

curl -X POST "http://localhost:9002/gateway/{serverToken}/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Main APIs

Endpoint Description
POST /v1/openapi/upload Import an OpenAPI document
POST /v1/openapi/updateForAuth Update auth settings
POST /v1/mcpServer/list List MCP servers
POST /v1/mcpServer/createByForm Create a server manually
POST /v1/mcpServer/updateMcpServerByForm Update a manually created server
POST /v1/mcpServer/getMcpServerInfoByUUID Get server detail
POST /v1/mcpServer/getMcpConnectTokenByUUID Generate a connect token
POST /v1/mcpServer/getMcpServerToolsByUUID List tools under a server
POST /v1/mcpServer/createMcpServerTool Create a tool
POST /v1/mcpServer/updateMcpServerTool Update a tool
POST /v1/mcpServer/testMcpServerTool Test a tool request
POST /gateway/:serverToken/mcp MCP gateway

Project Structure

api/                  HTTP API layer
cmd/                  application entry + wire
configs/              configuration files
docs/                 documents and screenshots
internal/             business logic, data, MCP runtime
middleware/           middleware
pkg/                  shared utilities
router/               route registration
web/                  frontend management UI

License

MIT

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Restful To MCP

How do I install Restful To MCP?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Restful To MCP safe to use with an AI agent?

Its trust score is 34 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Restful To MCP still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.