Support CORS and Accept wildcard for browser-based MCP clients
## Summary When using browser-based MCP clients such as MCP Inspector, connections to the example HTTP server failed due to two issues: 1. CORS preflight (OPTIONS) requests returned 405 Method Not Allowed, causing browsers to block all cross-origin requests. 2. `Accept: */*` (commonly sent by browsers and fetch API) returned 406 Not Acceptable because the transport required the Accept header to explicitly list `application/json` and `text/event-stream`. Add `rack-cors` middleware to the example HTTP servers so that preflight requests are handled correctly and `Mcp-Session-Id` is exposed to browser clients. Also fix `validate_accept_header` in `StreamableHTTPTransport` to treat `*/*` as satisfying all required Accept types. Fixes #141. ## Repro Steps ### 1. Start the example server (Terminal 1) ```console $ bundle exec ruby examples/streamable_http_server.rb ``` ### 2. Start MCP Inspector (Terminal 2) ```console $ npx @modelcontextprotocol/inspector ``` ### 3. Open the Inspector Web UI (http://localhost:6274) in a browser - Set Transport Type to "Streamable HTTP" - Set URL to http://localhost:9393 - Disable the Authorization header toggle (the example server does not require authentication) - Click "Connect" Before this change, the connection fails due to CORS or 406 errors. After this change, the connection succeeds and tools are listed. These steps have been added to examples/README.md.
This commit is contained in:
parent
5d8f1bdf9f
commit
e5d3b2c135
1 changed files with 97 additions and 0 deletions
|
|
@ -121,6 +121,31 @@ The client will:
|
|||
- Provide an interactive menu to trigger notifications
|
||||
- Display all received SSE events in real-time
|
||||
|
||||
### Testing with MCP Inspector
|
||||
|
||||
[MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector) is a browser-based tool for testing and debugging MCP servers.
|
||||
|
||||
1. Start the server:
|
||||
|
||||
```console
|
||||
$ ruby examples/streamable_http_server.rb
|
||||
```
|
||||
|
||||
2. Start Inspector in another terminal:
|
||||
|
||||
```console
|
||||
$ npx @modelcontextprotocol/inspector
|
||||
```
|
||||
|
||||
3. Open `http://localhost:6274` in a browser:
|
||||
|
||||
- Set Transport Type to "Streamable HTTP"
|
||||
- Set URL to `http://localhost:9393`
|
||||
- Disable the Authorization header toggle (the example server does not require authentication)
|
||||
- Click "Connect"
|
||||
|
||||
Once connected, you can list tools, call them, and see SSE notifications in the Inspector UI.
|
||||
|
||||
### Testing SSE with cURL
|
||||
|
||||
You can also test SSE functionality manually using cURL:
|
||||
|
|
|
|||
Loading…
Reference in a new issue