MCP Server from OpenAPI
Description
# MCP Server from OpenAPI A MCP server implementation from OpenAPI specifications, supporting both SSE (Server-Sent Events) and streaming responses. ## Prerequisites - Python 3.x - pip (Python package manager) - Anthropic API key (for MCP clients) - Google API key (for ADK…
About
# MCP Server from OpenAPI A MCP server implementation from OpenAPI specifications, supporting both SSE (Server-Sent Events) and streaming responses. ## Prerequisites - Python 3.x - pip (Python package manager) - Anthropic API key (for MCP clients) - Google API key (for ADK agents) ## Installation 1. Create and…
Details
- Author
- rajeshm7910
- Downloads
- 278
- Categories
- Other, API
Jump to
- OpenAPI specification-based endpoint generation
- Support for both SSE and streaming responses
- Multiple client implementations (MCP and ADK)
- Easy configuration through environment variables
- Example usage with httpbin.org API
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
MCP Server from OpenAPICommand (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
Install Python 3.x and pip, create a virtual environment, and run pip install -r requirements.txt. Start the server in SSE mode (python server/mcp_server_sse.py --spec <file> --name <name> --base-url <url>) or streaming mode (python server/mcp_server_stream.py ...). Then launch either the SSE client (python client/sse_client.py) or streaming client (python client/stream_client.py). For ADK agents, install google-adk, replace a mcp_session_manager.py file, and configure .env files with the appropriate API keys.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp server from openapi": {
"mcp-server-from-openapi": {
"command": "python3",
"args": [
"-m",
"venv",
"venv"
]
}
}
}
}McpServers
{
"mcp-server-from-openapi": {
"command": "python3",
"args": [
"-m",
"venv",
"venv"
]
}
}MCP Server from OpenAPI
A MCP server implementation from OpenAPI specifications, supporting both SSE (Server-Sent Events) and streaming responses.
Prerequisites
- Python 3.x
- pip (Python package manager)
- Anthropic API key (for MCP clients)
- Google API key (for ADK agents)
Installation
1. Create and activate a virtual environment:
python3 -m venv venv
source venv/bin/activate
2. Install dependencies:
pip install -r requirements.txt
Server Setup
The server can be run in two modes:
SSE Mode
python server/mcp_server_sse.py --spec server/httpbin_openapi.yaml --name httpbin --base-url https://httpbin.org
Streaming Mode
python server/mcp_server_stream.py --spec server/httpbin_openapi.yaml --name httpbin --base-url https://httpbin.org
Client Setup
MCP Clients
1. Create a .env file in the project root and add your Anthropic API key:
ANTHROPIC_API_KEY=your_api_key_here
2. Run the client of your choice:
- For SSE client:
python client/sse_client.py
- For streaming client:
python client/stream_client.py
Example usage with either MCP or streaming client:
MCP Client Started!
Type your queries or 'quit' to exit.
Query: Get Headers
I'll help you get the headers using the api_call function.
[Calling tool api_call with args {'kwargs': '{"action": "get_headers"}'}]
Here are the headers from the response:
{
"Accept": "/",
"Accept-Encoding": "gzip, deflate",
"Content-Type": "application/json",
"Host": "httpbin.org",
"User-Agent": "python-httpx/0.28.1",
"X-Amzn-Trace-Id": "Root=1-683fecc4-674af7e9323b027c4b9bc740"
}
ADK Agents
Prerequisites
1. Install ADK:
Setup Steps
1. Important: Streaming mode workaround
- Download the latest mcp_session_manager.py from Google ADK repository
- Replace the existing file in your ADK installation:
2. Navigate to the Clients directory:
3. Configure the environment:
- Add the following to .env file in both httpb_sse_agent and httpbin_stream_agent directories:
4. Start the ADK web interface:
Features
- OpenAPI specification-based endpoint generation
- Support for both SSE and streaming responses
- Multiple client implementations (MCP and ADK)
- Easy configuration through environment variables
Troubleshooting
ADK Streaming Mode Issues
If you encounter issues with ADK agents in streaming mode:
1. Verify you've replaced the mcp_session_manager.py file
2. Check your Google API key is correctly set in the .env` files
3. Ensure you're using the latest version of ADK
License
This project is licensed under the Apache 2.0 License.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
