leizongmin/mcp-server-proxy

Converts the SSE transport layer of the MCP protocol into a proxy server for standard HTTP request/response, simplifying the development and use of MCP Server.

Why is this tool needed?

MCP (Model Context Protocol) is an open protocol that provides standardized data source and tool integration solutions for AI applications. Currently, MCP supports two main transmission protocols:

1. Stdio Transmission Protocol:

• 😫 Command-line tools must be installed locally for the user, with specific requirements for the runtime environment
• 😫 Users need to configure the appropriate environment

2. SSE (Server-Sent Events) Transport Protocol:

• 👍 Based on HTTP long connection implementation, user configuration is relatively simple, mainly by setting the service address
• 😫 Currently, there are relatively few related development tools and examples

This tool simplifies the development and use of MCP Server in the following ways:

1. Uses the SSE transport protocol to interact with the MCP Client; users only need to configure the service address to use it
2. Convert MCP tool calls into standard HTTP requests/responses, allowing developers to implement them in any programming language without worrying about SSE protocol details

Functional Features

• Supports converting the SSE transport layer of the MCP protocol into standard HTTP requests/responses
• Provides request and response checking functions, mainly used to study the interaction process between MCP Client and Server
• Currently supports three methods: initialize, tools/list, and [T2].

Installation

How to use

The tool provides two main commands:

1. inspect command

Used to check the content of requests and responses, mainly to study the interaction process between MCP Client and Server:

For example:

2. serve command

Start the proxy server and convert the call from the MCP Client into a standard HTTP request/response:

For example:

Example

The project includes a JavaScript example (located in the example/js-echo directory), which implements simple echo functionality without relying on MCP-related SDKs, only managing a few simple HTTP requests:

1. Enter the sample directory:

This example uses the Hono framework, with the core code as follows:

2. Install dependencies:

3. Starting the server:

4. Start the proxy server:

5. Configure the MCP Client:

• Type: sse
• Server URL: http://localhost:3002/sse

6. Call the tool:

Taking Cursor as an example, after submitting content echo message "hello", it will recognize that the echo tool needs to be called. At this point, a [Call Tool] button will appear. Click the click ‘Second’ to confirm and you will see the tool call result.

License

MIT

Contribution

Feel free to submit questions and Pull Requests!