Skip to content

Conversation

@MAVRICK-1
Copy link

HTTP Streamable Transport Migration

Summary

This PR implements HTTP Streamable Transport support for the Supadata MCP server, addressing the GitHub issue #2 and Smithery's STDIO transport deprecation by September 7, 2025.

Changes

  • Added HTTP Transport: New src/httpServer.ts with full MCP 2025-03-26 protocol support
  • Dual Transport Support: Server now supports both STDIO and HTTP modes via MCP_TRANSPORT_MODE environment variable
  • Updated Dependencies: Added Express, CORS, and HTTP transport packages
  • New Scripts: Added start:http and dev:http commands in package.json
  • Enhanced Documentation: Updated CLAUDE.md and added comprehensive MIGRATION.md
  • Backwards Compatibility: Existing STDIO integrations continue to work unchanged

Testing

HTTP Transport

SUPADATA_API_KEY=your_key npm run start:http
# Server runs on port 3000 with endpoints /mcp and /health

STDIO Transport (Legacy)

SUPADATA_API_KEY=your_key npm run start:stdio
# Compatible with existing Claude Desktop/MCP integrations
Screenshot from 2025-08-28 15-08-27
Screencast.from.2025-08-28.15-44-19.mp4

Migration Benefits

  1. Future-Proof: Ready for MCP protocol evolution
  2. Web-Native: Enables browser-based integrations
  3. Scalable: Supports load balancing and multiple instances
  4. Standards-Compliant: Full adherence to MCP 2025-03-26 specification

Deployment

The HTTP transport is ready for production deployment on any cloud platform (AWS, Google Cloud, Azure, Heroku, etc.) while maintaining full compatibility with existing STDIO-based integrations.

Fixes #2
/claim #2

- Add HTTP transport implementation in src/httpServer.ts
- Update package.json with HTTP transport scripts and dependencies
- Enhance src/index.ts to support both STDIO and HTTP modes
- Add comprehensive MIGRATION.md documentation
- Maintain backwards compatibility with STDIO transport
- Support MCP protocol version 2025-03-26 specification
@MAVRICK-1
Copy link
Author

cc @rafalzawadzki

@rafalzawadzki
Copy link
Contributor

@MAVRICK-1 thank you for your contribution. Someone else was first with a complete solution already and was awarded the bounty: #3

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Upgrade to Streamable HTTP transport

2 participants