Repository navigation
feat: support custom headers for HTTP/SSE transports - #29
Merged
maplezzk merged 2 commits intoApr 28, 2026
Merged
Conversation
added 2 commits
April 28, 2026 10:33
Pass headers from server config to StreamableHTTPClientTransport and SSEClientTransport via requestInit. This enables authentication for HTTP-based MCP servers (e.g. Arthas MCP) that require Authorization or other custom headers. Changes: - config.ts: add optional 'type' and 'headers' fields to HttpServerConfigSchema - client.ts: read config.headers and pass as requestInit.headers to transports - Environment variable placeholders in header values are resolved
- detectServerType: http, sse, stdio detection - StreamableHTTP: headers passed, no headers, env placeholder resolution, missing env error - SSE: headers passed, no headers, env placeholder resolution - HttpServerConfigSchema: headers/type validation, reject invalid type/non-string headers 17 new tests, all 62 tests passing.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
When connecting to HTTP-based MCP servers that require authentication (e.g., Arthas MCP with
Authorization: Bearer <token>), the connection fails because custom headers from the server config are not passed to the transport layer.The
headersfield in the config is silently ignored, causing 401/403 errors for servers that require authentication.Solution
src/types/config.ts: Added optionaltypeandheadersfields toHttpServerConfigSchemasrc/core/client.ts: Readconfig.headersand pass them viarequestInit.headersto bothStreamableHTTPClientTransportandSSEClientTransport\${VAR}) in header values are resolved automaticallyConfig Example
{ "mcpServers": { "arthas-mcp": { "type": "streamableHttp", "url": "http://172.1.6.196:8563/mcp", "headers": { "Authorization": "Bearer \${ARTHAS_TOKEN}" } } } }Testing
Tested with Arthas MCP server (v4.1.8) which requires Bearer token authentication:
Failed to list tools: Streamable HTTP error: Error POSTing to endpointarthas-mcp Connected 30 tools