MCP2HTTP
MCP2HTTP is a minimal transport adapter that bridges MCP clients using stdio with stateless HTTP servers.
Overview
MCP2HTTP is a minimal transport adapter that bridges Model Context Protocol (MCP) clients using stdio with stateless HTTP servers, enabling new integration possibilities.
To use MCP2HTTP, configure your MCP client to call the command with the endpoint URL and optional HTTP headers in the specified format. For example: npx -y mcp2http <endpoint-url> ["Header: Value"...].
- Client-generated session tracking with UUID
Session-Idheader. - Capability filtering to block unsupported requests. - Notification handling that drops messages with no ID.
- Connecting local MCP clients to remote HTTP servers.
- Integrating legacy systems with modern HTTP-based services.
- Reducing server load by filtering unsupported capabilities.
Add to your AI client
Use these steps to connect MCP2HTTP in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mcp2http-tekorex": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp2http-tekorex"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mcp2http-tekorex": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp2http-tekorex"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcp2http-tekorex": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp2http-tekorex"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcp2http-tekorex": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp2http-tekorex"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp2http-tekorex": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp2http-tekorex"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcp2http-tekorex": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp2http-tekorex"
]
}
}
}FAQ
What is the purpose of the `Session-Id` header?
It allows for correlation of requests in stateless HTTP environments, though it is optional for servers that do not require session tracking.
Can I use MCP2HTTP with any HTTP server?
Yes, as long as the server supports the Model Context Protocol.
Is there a license for MCP2HTTP?
Yes, MCP2HTTP is licensed under the MIT license.