This standalone MCP server runs SSE transport over HTTP and exposes API endpoints as tools for AI assistants to call, enabling you to integrate OpenAPI-defined capabilities into your workflows with ease.

How to use

You connect your MCP client to the SSE endpoint exposed by this server to access the available tools. Start the server, then point your MCP client at the provided connection URL to discover and invoke those tools.

How to install

Prerequisites: Python 3.10 or higher and pip.

# 1. Extract the package
# unzip and navigate into the project directory

unzip mcp_sdk_petstore_api_44.zip cd mcp_sdk_petstore_api_44

2. Install dependencies

pip install -r requirements.txt

# 3. Configure authentication (if required by your API)
# Edit config.json and set the auth_config section as needed

Open config.json in your editor and update auth_config

4. Run the server

python main.py

# 5. Note the MCP URL from the startup output

MCP Connection URL: http://localhost:8000/sse

## Additional sections

Configuration, security, troubleshooting, and example usage are described below to help you run and connect to the MCP server smoothly.

## Changing host and port

Edit the server configuration to change the host or port.

{ "host": "0.0.0.0", "port": 8000 }

## Connecting MCP clients

Your MCP client uses the SSE endpoint at the configured URL.

Example MCP connection URL to use in your client:

http://localhost:8000/sse

## Claude Desktop (SSE Mode)

If your Claude Desktop supports SSE transport, configure the client to connect to the MCP server at the SSE URL.

{ "mcpServers": { "mcp_sdk_petstore_api_44": { "url": "http://localhost:8000/sse", "transport": "sse" } } }

## Cursor / Custom MCP Clients

Configure your client to connect to the SSE endpoint.

Key details you will use:

URL: http://localhost:8000/sse
Transport: SSE / Server-Sent Events
Method: GET to establish the SSE connection; POST for messages to /messages if your client uses a messages endpoint.

## Testing with curl

Verify the server is running and reachable with simple requests.

Health check

curl http://localhost:8000/health

Connect to SSE endpoint (will stream events)

curl -N http://localhost:8000/sse

## Understanding the package structure

Key files define configuration, tools, and the server logic. You will typically modify config.json to point to your target API, and tools.json to describe the available endpoints as tools for the MCP client.

## Authentication

If your target API requires authentication, you can configure credentials in the config.json under auth\_config. Supported schemes include API keys (header or query), bearer tokens, basic authentication, and OAuth2. The server automatically adds the necessary authentication headers or parameters to API requests.

{ "type": "apiKey", "credentials": { "location": "header", "name": "X-API-Key", "value": "your-api-key-here" } }