midnight-mcp 0.1.41 → 0.2.2

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

package/dist/bin.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import {
+  startHttpServer,
+  startServer
+} from "./chunk-S7G4OHA4.js";
+import {
+  setOutputFormat
+} from "./chunk-HOWO4K5A.js";
+
+// src/bin.ts
+import { config } from "dotenv";
+import { resolve } from "path";
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+config({ path: resolve(process.cwd(), ".env") });
+var CURRENT_VERSION = "0.2.2";
+process.on("uncaughtException", (error) => {
+  console.error("Uncaught exception:", error);
+  process.exit(1);
+});
+process.on("unhandledRejection", (reason) => {
+  console.error("Unhandled rejection:", reason);
+  process.exit(1);
+});
+var argv = yargs(hideBin(process.argv)).scriptName("midnight-mcp").usage("$0 [options]").option("http", {
+  type: "boolean",
+  description: "Use HTTP transport with SSE support",
+  default: false
+}).option("port", {
+  type: "number",
+  description: "HTTP port (when using --http)",
+  default: 3e3
+}).option("github-token", {
+  type: "string",
+  description: "GitHub token for API access (overrides GITHUB_TOKEN env var)"
+}).option("json", {
+  type: "boolean",
+  description: "Output results in JSON format (default: YAML for better LLM efficiency)",
+  default: false
+}).example(
+  "$0 --stdio",
+  "Start server with stdio transport (for Claude Desktop)"
+).example("$0 --http --port 3000", "Start HTTP server on port 3000").help().alias("h", "help").version(CURRENT_VERSION).alias("v", "version").strict().parseSync();
+if (argv["github-token"]) {
+  process.env.GITHUB_TOKEN = argv["github-token"];
+}
+setOutputFormat(argv.json);
+var useHttp = argv.http;
+async function main() {
+  if (useHttp) {
+    await startHttpServer(argv.port);
+  } else {
+    await startServer();
+  }
+}
+main().catch((error) => {
+  console.error("Failed to start server:", error);
+  process.exit(1);
+});
+//# sourceMappingURL=bin.js.map