logo
Login
Cover image
Openapi-MCP-Proxy
Private

Openapi-MCP-Proxy

Try Now
2025-04-14

Herramienta CLI para crear un servidor MCP que exponga servicios a partir de una especificación de OpenAPI

3 years

Works with Finder

1

Github Watches

0

Github Forks

1

Github Stars

🤖 OpenAPI MCP Server

asciicast

A command-line tool that transforms any OpenAPI service into a Model Context Protocol (MCP) server, enabling seamless integration with AI agents and tools that support the MCP specification.

[!NOTE] This tool is still in early development stage. Roadmap is here

What is Model Context Protocol (MCP)?

Model Context Protocol (MCP) is a standardized protocol for AI agents to interact with external tools and services. It provides a consistent way for AI models to discover, understand, and utilize various capabilities through a unified interface, making it easier to build AI-powered applications that can interact with multiple services.

What is OpenAPI?

OpenAPI (formerly known as Swagger) is a specification for machine-readable interface files for describing, producing, consuming, and visualizing RESTful web services. It allows both humans and computers to discover and understand the capabilities of a service without needing to access the source code or additional documentation.

About This Project

This middleware acts as a bridge between OpenAPI services and MCP clients. It:

  1. Takes an OpenAPI specification file as input
  2. Automatically generates an MCP-compliant server
  3. Proxies incoming requests to the actual OpenAPI service
  4. Translates between MCP and REST conventions

This enables any existing REST API with an OpenAPI specification to be immediately accessible to AI agents that understand MCP, without requiring any modifications to the original service.

Installation

npm install -g openapi-mcp-proxy

Usage

npx openapi-mcp-proxy --spec ./path/to/openapi.yml --target http://your-api.com --port 3000

Options

  • -s, --spec <path> (required): Path to your OpenAPI specification file
  • -t, --target <url> (optional): Target URL of the API service (default: http://localhost:8080)
  • -p, --port <number> (optional): Port to run the MCP server on (default: 3000)
  • -V, --version: Display version number
  • -h, --help: Display help for command

Example

Start an MCP server for the Petstore API

npx openapi-mcp-proxy --spec resources/petstore.openapi.yml --target https://petstore.swagger.io/v2

Testing

MCP Inspector

To test your MCP server, you can use the Model Context Protocol:

  1. Install the MCP Inspector:
npx @modelcontextprotocol/inspector
  1. Start your MCP server
  2. Navigate to the inspector's UI and fill in the correct server path ending with /mcp like http://localhost:3000/mcp
  3. Now you can interact with your MCP server. The MCP Inspector will show you detailed information about the requests and responses.

with VS Code

It's easier to use this with VS Code's built-in agent mode:

  1. Open VS Code and enable agent mode:
    • Press Cmd/Ctrl + Shift + P
    • Type "Toggle GitHub Copilot Agent Mode"
    • Select "Enable"
  2. Add your MCP server:
    • Press Cmd/Ctrl + Shift + P
    • Type "MCP: add Server"
    • type your MCP server URL like http://localhost:3000/mcp ending with /mcp
  3. Your github copilot chat should pick up on the new tools it has!
  4. Now you can interact with your MCP server through VS Code's agent interface. Try asking it "how many pets are available right now?"

for more information on how to use MCP servers with VS code, see this

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. Roadmap is here

License

MIT

相关推荐

puerto

puerto

  • av

    • Ejecute sin esfuerzo LLM Backends, API, frontends y servicios con un solo comando.

    2 (1)
    1 panel

    1 panel

  • 1Panel-dev

    • 🔥 1Panel proporciona una interfaz web intuitiva y un servidor MCP para administrar sitios web, archivos, contenedores, bases de datos y LLM en un servidor de Linux.

    2 (1)
    rulego

    rulego

  • rulego

    • ⛓️Rulego es un marco de motor de regla de orquestación de componentes de alta generación de alto rendimiento, de alto rendimiento y de alto rendimiento para GO.

    3.7 (10)
    impresionante-llm-recesses

    impresionante-llm-recesses

  • WangRongsheng

    • 🧑‍🚀 全世界最好的 llM 资料总结（数据处理、模型训练、模型部署、 O1 模型、 MCP 、小语言模型、视觉语言模型） | Resumen de los mejores recursos del mundo.

    3.5 (4)
    Funciones LLM

    Funciones LLM

  • sigoden

    • Cree fácilmente herramientas y agentes de LLM utilizando funciones Plain Bash/JavaScript/Python.

    1 (1)
    CPP-MCP

    CPP-MCP

  • hkr04

    • SDK liviano C ++ MCP (Protocolo de contexto del modelo)

    3 (1)
    Langbot

    Langbot

  • RockChinQ

    • 😎简单易用、🧩丰富生态 - 大模型原生即时通信机器人平台 | 适配 Qq / 微信（企业微信、个人微信） / 飞书 / 钉钉 / Discord / Telegram / Slack 等平台 | 支持 Chatgpt 、 Deepseek 、 DiFy 、 Claude 、 Gemini 、 Xai 、 PPIO 、 Ollama 、 LM Studio 、阿里云百炼、火山方舟、 Siliconflow 、 Qwen 、 Moonshot 、 Chatglm 、 SillyTraven 、 MCP 等 LLM 的机器人 / Agente | Plataforma de bots de mensajería instantánea basada en LLM, admite Discord, Telegram, WeChat, Lark, Dingtalk, QQ, Slack

    5 (1)
    mínimos

    mínimos

  • dmayboroda

    • Trapo conversacional local con contenedores configurables

    3 (5)
    agente

    agente

  • modelscope

    • Iniciar aplicaciones de múltiples agentes empoderadas con Building LLM de manera más fácil.

    2 (1)
    test_mcp

    test_mcp

  • paulwing

    • Un repositorio de pruebas creado con el servicio MCP

    3.3 (10)

    Reviews

    3.2 (12)
    Avatar
    user_vxbbvqZt
    2025-04-26

    openapi-mcp-proxy by JacerOmri is a game-changer for developers! The seamless integration and user-friendly interface make API management a breeze. It has significantly streamlined our workflow and increased productivity. Highly recommend to anyone looking for a reliable and efficient solution!

    Avatar
    user_CxHTLK4A
    2025-04-26

    As a dedicated user of openapi-mcp-proxy by JacerOmri, this tool has significantly improved my workflow efficiency. The seamless integration and robust features make it an indispensable asset for developers. Highly recommend exploring its capabilities!

    Avatar
    user_vuCqzD9b
    2025-04-26

    I've been using the openapi-mcp-proxy extensively in my projects and it has been a game changer. Developed by JacerOmri, this tool is incredibly efficient and easy to integrate. The seamless communication with various APIs has significantly sped up my workflow. The initial setup is user-friendly, and the provided documentation is clear and comprehensive. Highly recommended for anyone looking to streamline their API integrations!

    Avatar
    user_vpXxqqzo
    2025-04-26

    openapi-mcp-proxy by JacerOmri is an exceptional tool for facilitating API integrations. It streamlines the process, making it incredibly efficient and user-friendly. The seamless operation and clear documentation significantly reduce development time. Highly recommended for all developers.

    Avatar
    user_ySZI1Vx2
    2025-04-26

    I have been using the openapi-mcp-proxy by JacerOmri and it has significantly streamlined my API integrations. The seamless proxy service allows for efficient communication between different endpoints, making my development process much smoother. Highly recommended for anyone looking to enhance their API workflows!

    Avatar
    user_7foKmFMR
    2025-04-26

    I've been using the openapi-mcp-proxy by JacerOmri and it has significantly improved my workflow. It's incredibly efficient and user-friendly. The seamless integration and performance are outstanding. Highly recommend it to anyone looking for a reliable proxy solution for their applications!

    Avatar
    user_SNkP7qFt
    2025-04-26

    As a dedicated user of the openapi-mcp-proxy created by JacerOmri, I can confidently say that it's a seamless integration tool that dramatically simplifies my workflow. Its user-friendly interface and efficient communication capabilities between APIs significantly enhance productivity. This product is a must-have for anyone reliant on robust API connections.

    Avatar
    user_1G2WuTi8
    2025-04-26

    I've been using the openapi-mcp-proxy by JacerOmri and it's been a game changer! The seamless integration and reliability have significantly improved my workflow. Highly recommended for anyone looking to enhance their API management experience.

    Avatar
    user_l4v7AVtA
    2025-04-26

    As a dedicated user of mcp applications, I find the openapi-mcp-proxy by JacerOmri to be exceptionally reliable and efficient. Its seamless integration and robust performance have significantly enhanced my workflows. Highly recommended!

    Avatar
    user_3Udz2ara
    2025-04-26

    As a dedicated user of the openapi-mcp-proxy by JacerOmri, I must say that this product truly excels in its field. It offers seamless integration and performs exceptionally well. The user interface is intuitive, and the performance is reliable. Highly recommend it!

    Avatar
    user_Xq1mHbG3
    2025-04-26

    As a dedicated user of the openapi-mcp-proxy by JacerOmri, I am thoroughly impressed with its seamless integration and efficient performance. The proxy enhances my experience by allowing smooth interaction with APIs. It's a game-changer for developers seeking reliable and robust API communication. Highly recommended!

    Avatar
    user_ABh4X2gp
    2025-04-26

    As a loyal user of the openapi-mcp-proxy by JacerOmri, I must say this product has significantly enhanced my integration capabilities. The seamless proxy configurations and robust performance have made workflow automation a breeze. Highly recommend it to anyone looking to optimize their API management processes.