**🔥 This service channels the divine MCP protocol through native StreamableHTTP glory! ⚡**
Sign in to like and favorite skills
🔥 This service channels the divine MCP protocol through native StreamableHTTP glory! ⚡
⚡ Native MCP implementation - No wrapped servers, pure protocol enlightenment! ⚡
This blessed service implements:
🔱 This service exists in Layer 3 - The Pure Protocol Servants of Glory! 🔱
⚡ This service knows only MCP protocol - authentication is Traefik's divine responsibility! ⚡
The Holy
Endpoint - The Single Gateway to Protocol Paradise!/mcp
POST /mcp # JSON-RPC request processing GET /mcp # SSE endpoint (infrastructure ready, not yet implemented) DELETE /mcp # Session termination (infrastructure ready)
Divine Protocol Methods Implemented:
initializetools/listtools/callDeclared Capabilities:
{ "tools": {}, // Full tool support blessed! "prompts": null, // Not implemented (honest declaration!) "resources": null, // Not implemented (truthful admission!) "logging": null // Not implemented (sacred transparency!) }
🌐 Divine URL retrieval with security blessings! 🌐
{ "name": "fetch", "description": "Fetch a URL and return its contents", "inputSchema": { "type": "object", "properties": { "url": { "type": "string", "description": "The URL to fetch", "format": "uri" }, "method": { "type": "string", "description": "HTTP method to use", "enum": ["GET", "POST"], "default": "GET" }, "headers": { "type": "object", "description": "Optional HTTP headers to send" }, "body": { "type": "string", "description": "Optional request body (for POST requests)" }, "max_length": { "type": "integer", "description": "Maximum response length in bytes", "default": 100000 }, "user_agent": { "type": "string", "description": "User agent string to use", "default": "ModelContextProtocol/1.0" } }, "required": ["url"] } }
⚡ SSRF Protection - Blocks access to internal networks! ⚡
🔒 Content Security:
⚙️ All configuration flows through blessed environment! ⚡
# Required Divine Configuration MCP_SERVER_NAME=mcp-fetch # Server identity declaration! MCP_SERVER_VERSION=1.0.0 # Version proclamation! MCP_PROTOCOL_VERSION=2025-06-18 # Protocol covenant version! # Optional Blessed Settings MCP_FETCH_ALLOWED_SCHEMES=["http","https"] # Allowed URL schemes! MCP_FETCH_MAX_REDIRECTS=5 # Redirect limit! MCP_FETCH_DEFAULT_USER_AGENT=ModelContextProtocol/1.0 (Fetch Server) MCP_FETCH_ENABLE_SSE=false # Future SSE support flag! # Server Configuration HOST=0.0.0.0 # Binding address! PORT=3000 # Sacred port 3000!
⚡ Never hardcode values - all config through environment or face damnation! ⚡
🏥 StreamableHTTP protocol health verification! 🏥
The divine health check uses protocol initialization:
healthcheck: test: ["CMD", "sh", "-c", "curl -s -X POST http://localhost:3000/mcp \ -H 'Content-Type: application/json' \ -d '{\"jsonrpc\":\"2.0\",\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"${MCP_PROTOCOL_VERSION:-2025-06-18}\",\"capabilities\":{},\"clientInfo\":{\"name\":\"healthcheck\",\"version\":\"1.0\"}},\"id\":1}' \ | grep -q '\"protocolVersion\":\"${MCP_PROTOCOL_VERSION:-2025-06-18}\"'"] interval: 30s timeout: 5s retries: 3 start_period: 40s
⚡ This blessed incantation verifies protocol readiness! ⚡
📛 Divine error responses follow JSON-RPC 2.0 scripture! 📛
-32700-32600-32601-32602-32603{ "content": [ { "type": "text", "text": "Error: <error message>" } ], "isError": true }
Text Content Response:
{ "content": [ { "type": "text", "text": "The fetched content (truncated if exceeds max_length)" } ] }
Image Content Response:
{ "content": [ { "type": "image", "data": "<base64-encoded-image-data>", "mimeType": "image/png" } ] }
🏗️ Modular design blessed by the Python gods! 🏗️
src/mcp_fetch_streamablehttp_server/ ├── __init__.py # Package initialization! ├── __main__.py # Entry point blessing! ├── server.py # FastAPI application divine core! ├── transport.py # StreamableHTTP transport implementation! └── fetch_handler.py # Fetch tool logic with security!
🧪 Test with real protocol interactions! No mocks allowed! ⚡
# Sacred test pattern async def test_fetch_tool(): """Test actual fetch operations against real endpoints""" # Use httpx to make real requests to running service # Verify actual protocol responses # Test security boundaries with real attempts
⚡ Remember: Integration tests against deployed service or face debugging hell! ⚡
🚀 This service follows all divine deployment commandments! 🚀
⚡ Deploy with docker-compose or face container chaos! ⚡
May your fetches be secure, your responses swift, and your protocol compliance eternal!