
openapi-mcp-server
This is a skeleton project that you can use as a starting point for building your own MCP server. The example addition function demonstrates how to implement handlers across all three protocols.
1
Github Watches
0
Github Forks
1
Github Stars
OpenAPI MCP Server
This is a skeleton project that you can use as a starting point for building your own MCP server. The example addition function demonstrates how to implement handlers across all three protocols.
Features
Current implementation status:
- ✅ Standard I/O (stdio)
- ✅ Server-Sent Events (SSE)
- ✅ OpenAPI/REST endpoints
Running Modes
The server supports three different modes of operation, controlled by the MODE
environment variable:
-
stdio
: Run as a standard I/O server -
sse
: Run as a Server-Sent Events server (port 8001) -
openapi
: Run as an OpenAPI/REST server (port 8002)
Building and Running
Using Docker Compose
- Build the container:
docker compose build
- Run specific services:
# Run all services
docker compose up
# Run only SSE server
docker compose up sse-mcp-server
# Run only OpenAPI server
docker compose up openapi-mcp-server
Using Docker directly
You can also run the server directly using Docker:
# Run in stdio mode
docker run -i --rm -e MODE=stdio 3loc/openapi-mcp-server
# Run in SSE mode
docker run -p 8001:8000 --rm -e MODE=sse 3loc/openapi-mcp-server
# Run in OpenAPI mode
docker run -p 8002:8000 --rm -e MODE=openapi 3loc/openapi-mcp-server
Configuration
The server can be configured using an mcp.json
file. Here's an example configuration:
{
"mcpServers": {
"stdio-mcp-server": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--name", "openapi-mcp-server",
"-e", "MODE=stdio",
"3loc/openapi-mcp-server"
]
},
"sse-mcp-server": {
"url": "http://localhost:8001/sse"
}
}
}
Development
The project provides a foundation for implementing an MCP server with multiple communication protocols. All three modes (stdio, SSE, and OpenAPI) are now implemented and can be used interchangeably based on your needs.
相关推荐
I find academic articles and books for research and literature reviews.
Confidential guide on numerology and astrology, based of GG33 Public information
Advanced software engineer GPT that excels through nailing the basics.
Converts Figma frames into front-end code for various mobile frameworks.
Take an adjectivised noun, and create images making it progressively more adjective!
Embark on a thrilling diplomatic quest across a galaxy on the brink of war. Navigate complex politics and alien cultures to forge peace and avert catastrophe in this immersive interstellar adventure.
Discover the most comprehensive and up-to-date collection of MCP servers in the market. This repository serves as a centralized hub, offering an extensive catalog of open-source and proprietary MCP servers, complete with features, documentation links, and contributors.
Micropython I2C-based manipulation of the MCP series GPIO expander, derived from Adafruit_MCP230xx
Mirror ofhttps://github.com/agentience/practices_mcp_server
The all-in-one Desktop & Docker AI application with built-in RAG, AI agents, No-code agent builder, MCP compatibility, and more.
Mirror ofhttps://github.com/bitrefill/bitrefill-mcp-server
Reviews

user_yriMOjiX
As a dedicated user of openapi-mcp-server, I must say it has significantly streamlined our API management processes. The robust features provided by 3loc have been highly reliable and easy to implement. The comprehensive documentation and seamless integration with various services make it a top-notch choice for developers. I highly recommend checking it out at https://github.com/3loc/openapi-mcp-server!