mcp-partner.github.io

MCP Partner is a client tool (web and desktop) designed to test and interact with MCP servers over SSE (Server-Sent Events) or Streamable HTTP. It behaves similarly to Postman but for MCP workflows: you point it at an MCP server, choose the transport (SSE or Streamable HTTP), and send requests while observing JSON-RPC style messages, responses, and notifications. The app can auto-detect and display available tools from the connected MCP server, generate input forms from each tool's Input Schema, and let you edit parameters in JSON if needed. It also supports saving and reusing configurations, and you can enable a proxy to bypass CORS and other browser restrictions when connecting to servers that don’t provide permissive CORS headers.

Prerequisites:

• A modern web browser (Chrome, Edge, Firefox) or the desktop app build of MCP Partner.
• Optional: Node.js and npm if you prefer running the project locally or building custom versions.

If you want to run the static web app directly:

1. Open the repository in your file explorer or clone it: git clone https://github.com/mcp-partner/mcp-partner.github.io.git
2. Navigate to the project root and open index.html in your browser.
3. The app is a static frontend and requires no local backend to connect to your MCP servers. If you publish or build locally, you can also deploy to Vercel or GitHub Pages per the project guidance.

If you want to deploy via the recommended hosting:

• Vercel: Use the Deploy with Vercel button in the repository and follow the prompts to deploy a static frontend with built-in CORS proxy support.
• GitHub Pages: Use the GitHub Actions workflow included in the project to publish the static build to GitHub Pages.

Note: Since this is a frontend client, there is no server process to install via npm. The recommended flow is to host the static files and connect to your MCP server endpoints directly or through a configured proxy.

Tips and considerations:

• CORS and proxies: When connecting from the browser to an MCP server, you may encounter CORS issues. The app supports built-in proxy options (e.g., Vercel edge proxy, public proxies) to work around this. You can enable proxying from the connection UI by clicking the shield icon on the connection bar.
• Protocols: The tool supports SSE (Server-Sent Events) and Streamable HTTP. Choose the appropriate transport per your MCP server’s capabilities.
• Tools and schemas: The app auto-discovers tools once connected. Use the form mode or JSON mode to provide input data according to each tool’s Input Schema. The app will remember your parameter sets for quick re-use.
• History and config exports: You can export/import server configurations in JSON to simplify migration between environments.
• Security: If you enable credentials or custom headers, ensure you’re only connecting to trusted MCP servers and that any sensitive data is handled securely in your browser.
• Desktop app: If using the Wails-built desktop version, it includes a built-in CORS proxy for local testing and can provide a more seamless experience on Windows, macOS, and Linux.