midnight-mcp 0.1.41 → 0.2.1

package/README.md

@@ -176,6 +176,38 @@ The API indexes **39 Midnight repositories**:
 
 ## Advanced Configuration
 
+### HTTP Mode
+
+Run as an HTTP server for web integrations or remote deployment:
+
+```bash
+# Start HTTP server on port 3000
+npx midnight-mcp --http --port 3000
+```
+
+Endpoints:
+
+- `/health` - Health check
+- `/mcp` - Streamable HTTP (MCP protocol)
+- `/sse` - Server-Sent Events
+
+### CLI Options
+
+```bash
+npx midnight-mcp --help
+
+Options:
+  --stdio          Use stdio transport (default, for Claude Desktop)
+  --http           Use HTTP transport with SSE support
+  --port <number>  HTTP port (default: 3000)
+  --json           Output in JSON (default: YAML for better LLM efficiency)
+  --github-token   GitHub token (overrides GITHUB_TOKEN env var)
+  -h, --help       Show help
+  -v, --version    Show version
+```
+
+> **Why YAML by default?** YAML is ~20-30% more token-efficient than JSON, which means AI assistants can process more context from tool responses.
+
 ### Local Mode
 
 Run everything locally for privacy or offline use:
@@ -225,5 +257,4 @@ The hosted API runs on Cloudflare Workers + Vectorize. See [api/README.md](./api
 
 MIT
 
-
 Thanks to all Stargazers ⭐️

package/dist/bin.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node