OpenAPI MCP Server
About
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.
Details
- Author
- 3loc
- GitHub stars
- 2
- Downloads
- 307
- Categories
- Other, API
Jump to
- Supports three transport modes: stdio, SSE, and OpenAPI
- Provides a starting point for building custom MCP servers
- Includes an example addition function handler
- Deployable via Docker or Docker Compose
- Configurable through environment variable MODE
- Can be used with mcp.json configuration file
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
OpenAPI MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Run the server using Docker or Docker Compose. Set the MODE environment variable to stdio, sse, or openapi to select the transport mode. Launch a specific service (e.g., docker compose up sse-mcp-server) or run directly with Docker (e.g., docker run -i --rm -e MODE=stdio 3loc/openapi-mcp-server). Configure the server using an mcp.json file.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"openapi mcp server": {
"openapi-mcp-server-3loc": {
"command": "docker",
"args": [
"compose",
"build"
]
}
}
}
}McpServers
{
"openapi-mcp-server-3loc": {
"command": "docker",
"args": [
"compose",
"build"
]
}
}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
1. Build the container:
docker compose build
2. Run specific services:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
