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 4 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 文档自动解析和表单手动创建两种方式。. It has been installed 0 times through Conduid.

Install

Clone
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 presentNot checked yet.
  • ·License declaredNot checked yet.
  • ·Tests presentNot checked yet.
  • ·Dependencies pinnedNot checked yet.
  • ·No dynamic code executionNot checked yet.
  • ·Scoped permissionsNot checked 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 mirrored from the source repository 4 months ago. The original is authoritative.

Questions

About Restful To MCP

How do I install Restful To MCP?

Run git clone https://github.com/lengyue1084/restful-to-mcp, then add the server to your MCP client's configuration. Conduid has recorded 0 installs, so the command is known to work with current clients.

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

Its trust score is 34 out of 100 (low). Conduid hasn't run static security checks on this repository yet, so review the source yourself before granting it credentials. 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.