feat(streamable-http): added streamable http transport

.dockerignore

@@ -0,0 +1,26 @@
+node_modules
+/dist
+
+.git
+.github
+
+.env
+.env.*
+
+npm-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+*.log
+.eslintcache
+.cache
+.tmp
+
+coverage
+.nyc_output
+
+.DS_Store
+.vscode
+.idea
+
+.cursor
+.agent-tools

Dockerfile

@@ -0,0 +1,24 @@
+# syntax=docker/dockerfile:1
+
+FROM node:22-alpine AS build
+WORKDIR /app
+
+COPY package.json package-lock.json ./
+RUN npm ci --omit=optional
+
+COPY tsconfig.json ./
+COPY src ./src
+COPY README.md ./
+RUN npm run build
+
+FROM node:22-alpine
+WORKDIR /app
+ENV NODE_ENV=production
+
+COPY package.json package-lock.json ./
+RUN npm ci --omit=dev --omit=optional
+COPY --from=build /app/dist ./dist
+
+USER node
+EXPOSE 3000
+CMD ["node", "dist/mcp.js"]

README.md

@@ -36,6 +36,35 @@ Installation will vary depending on your client, but in most cases you'll need t
 }
 ```
 
+### Streamable HTTP transport (optional)
+
+This server also exposes an HTTP transport using the MCP Streamable HTTP spec. Keep the stdio CLI entry as-is; use HTTP when you want to connect over a URL.
+
+- Endpoint: `GET/POST /mcp` (default path; configurable with `MCP_PATH`)
+- Port: `PORT` env (default `3000`)
+- Auth header (required): send either
+  - `Authorization: Bearer <CAL_API_KEY>`
+  - or `x-cal-api-key: <CAL_API_KEY>` (or `x-api-key`)
+
+Run locally (no build step):
+
+```bash
+PORT=3000 MCP_PATH=/mcp npm run dev
+```
+
+Connect with MCP Inspector:
+
+1. Open the Inspector.
+2. Transport: Streamable HTTP
+3. Server URL: `http://localhost:3000/mcp`
+4. Headers:
+   - `Authorization: Bearer <CAL_API_KEY>`
+   - Inspector handles required `Accept` headers automatically.
+
+Notes:
+- The server manages sessions per `mcp-session-id`. Your client should reuse this header automatically after initialization.
+- If you see “Server not initialized,” ensure your client reuses the same `mcp-session-id` for follow-up requests.
+
 ## Features
 
 This project supports tools for **all** Cal.com API endpoints by setting the `--all-tools` flags`. It also supports some prompt **workflows** tested in Cursor which allow you to quickstart Cal.com applications.