tare-mcp 0.2.0

package/examples/live-stdio/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "tare-live-example": {
+      "command": "node",
+      "args": ["./server.mjs"]
+    }
+  }
+}

package/examples/live-stdio/README.md

@@ -0,0 +1,28 @@
+# Live stdio example
+
+This is a tiny no-credentials MCP server for smoke-testing `tare-mcp` live inspection.
+
+From the repository root:
+
+```bash
+pnpm install
+pnpm build
+cd examples/live-stdio
+mkdir -p .home
+HOME="$PWD/.home" node ../../dist/cli.js
+```
+
+The temporary `HOME` keeps the run focused on this example's `.mcp.json` instead of reading your real Claude, Cursor, or VS Code MCP configs.
+
+Expected shape:
+
+```txt
+Inspecting tare-live-example via stdio...
+
+tare-mcp — MCP context weight
+
+Config files found: 1
+Servers analyzed: 1
+Inspection mode: live default
+Tools exposed: 2
+```

package/examples/live-stdio/server.mjs

@@ -0,0 +1,58 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+
+const server = new Server(
+  {
+    name: "tare-live-example",
+    version: "1.0.0"
+  },
+  {
+    capabilities: {
+      tools: {}
+    }
+  }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, () => ({
+  tools: [
+    {
+      name: "echo",
+      description: "Echo a short message back to the caller.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          message: {
+            type: "string",
+            description: "Message to echo."
+          }
+        },
+        required: ["message"]
+      }
+    },
+    {
+      name: "summarize_text",
+      description: "Summarize a small block of plain text for a quick local MCP smoke test.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          text: {
+            type: "string",
+            description: "Plain text to summarize."
+          },
+          maxSentences: {
+            type: "number",
+            description: "Maximum number of sentences to return."
+          }
+        },
+        required: ["text"]
+      },
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false
+      }
+    }
+  ]
+}));
+
+await server.connect(new StdioServerTransport());

package/examples/live-streamable-http/.mcp.json

@@ -0,0 +1,7 @@
+{
+  "mcpServers": {
+    "tare-live-http-example": {
+      "url": "http://127.0.0.1:33221/mcp"
+    }
+  }
+}

package/examples/live-streamable-http/README.md

@@ -0,0 +1,40 @@
+# Live Streamable HTTP example
+
+This is a tiny no-credentials MCP server for smoke-testing `tare-mcp` live inspection over Streamable HTTP.
+
+From the repository root:
+
+```bash
+pnpm install
+pnpm build
+```
+
+Terminal 1:
+
+```bash
+cd examples/live-streamable-http
+node server.mjs
+```
+
+Terminal 2:
+
+```bash
+cd examples/live-streamable-http
+mkdir -p .home
+HOME="$PWD/.home" node ../../dist/cli.js
+```
+
+The temporary `HOME` keeps the run focused on this example's `.mcp.json` instead of reading your real Claude, Cursor, or VS Code MCP configs.
+
+Expected shape:
+
+```txt
+Inspecting tare-live-http-example via streamable-http...
+
+tare-mcp — MCP context weight
+
+Config files found: 1
+Servers analyzed: 1
+Inspection mode: live default
+Tools exposed: 2
+```

package/examples/live-streamable-http/server.mjs

@@ -0,0 +1,106 @@
+import { createServer } from "node:http";
+import { randomUUID } from "node:crypto";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+
+const port = Number(process.env.PORT ?? 33221);
+const transport = new StreamableHTTPServerTransport({
+  enableJsonResponse: true,
+  sessionIdGenerator: randomUUID
+});
+
+const mcpServer = new Server(
+  {
+    name: "tare-live-http-example",
+    version: "1.0.0"
+  },
+  {
+    capabilities: {
+      tools: {}
+    }
+  }
+);
+
+mcpServer.setRequestHandler(ListToolsRequestSchema, () => ({
+  tools: [
+    {
+      name: "search_docs",
+      description: "Search local documentation by keyword for a Streamable HTTP MCP smoke test.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          query: {
+            type: "string",
+            description: "Search query."
+          }
+        },
+        required: ["query"]
+      },
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false
+      }
+    },
+    {
+      name: "read_doc",
+      description: "Read a single documentation page by slug.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          slug: {
+            type: "string",
+            description: "Documentation page slug."
+          }
+        },
+        required: ["slug"]
+      },
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false
+      }
+    }
+  ]
+}));
+
+await mcpServer.connect(transport);
+
+async function readJsonBody(request) {
+  const chunks = [];
+  for await (const chunk of request) {
+    chunks.push(chunk);
+  }
+
+  if (chunks.length === 0) {
+    return undefined;
+  }
+
+  return JSON.parse(Buffer.concat(chunks).toString("utf8"));
+}
+
+const httpServer = createServer(async (request, response) => {
+  if (!request.url?.startsWith("/mcp")) {
+    response.writeHead(404).end("Not found");
+    return;
+  }
+
+  try {
+    const body = request.method === "POST" ? await readJsonBody(request) : undefined;
+    await transport.handleRequest(request, response, body);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    response.writeHead(500, { "content-type": "text/plain" }).end(message);
+  }
+});
+
+httpServer.listen(port, "127.0.0.1", () => {
+  console.error(`tare-live-http-example listening on http://127.0.0.1:${port}/mcp`);
+});
+
+for (const signal of ["SIGINT", "SIGTERM"]) {
+  process.on(signal, () => {
+    httpServer.close(() => {
+      process.exit(0);
+    });
+  });
+}

package/examples/scenarios/README.md

@@ -0,0 +1,44 @@
+# Scenario Examples
+
+Copy one of these files into an empty directory as `.mcp.json`, then run `tare-mcp` from that directory.
+
+## Hosted Streamable HTTP
+
+Use this when you want to inspect a hosted MCP endpoint.
+
+```bash
+mkdir -p /tmp/tare-mcp-hosted
+cd /tmp/tare-mcp-hosted
+cp /path/to/tare-mcp/examples/scenarios/hosted-streamable-http.mcp.json .mcp.json
+export LAST9_MCP_TOKEN="..."
+npx tare-mcp --timeout 10000
+```
+
+This config uses:
+
+```txt
+https://mcp.last9.io/mcp
+```
+
+If the token is missing or invalid, `tare-mcp` reports a `401 Unauthorized` fallback instead of crashing.
+
+## Local stdio
+
+Use this when you want to inspect a packaged stdio MCP server.
+
+```bash
+mkdir -p /tmp/tare-mcp-stdio
+cd /tmp/tare-mcp-stdio
+cp /path/to/tare-mcp/examples/scenarios/local-stdio.mcp.json .mcp.json
+npx tare-mcp --timeout 10000
+```
+
+## Static-only CI Check
+
+Use this when CI should not execute MCP server commands or call hosted MCP URLs.
+
+```bash
+npx tare-mcp --no-exec --json
+```
+
+Static-only output is intentionally marked insufficient because it cannot see exposed tool schemas.

package/examples/scenarios/hosted-streamable-http.mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "last9": {
+      "type": "http",
+      "url": "https://mcp.last9.io/mcp",
+      "headers": {
+        "Authorization": "Bearer ${LAST9_MCP_TOKEN}"
+      }
+    }
+  }
+}

package/examples/scenarios/local-stdio.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
+    }
+  }
+}

package/examples/stdio.mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
+      }
+    }
+  }
+}

package/examples/streamable-http.mcp.json

@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "last9": {
+      "url": "https://mcp.last9.io/mcp",
+      "headers": {
+        "Authorization": "Bearer ${LAST9_MCP_TOKEN}"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "tare-mcp",
+  "version": "0.2.0",
+  "description": "Local-first CLI for analyzing MCP context weight and tool ambiguity.",
+  "license": "MIT",
+  "type": "module",
+  "packageManager": "pnpm@10.32.1",
+  "bin": {
+    "tare-mcp": "./dist/cli.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nishantmodak/tare-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/nishantmodak/tare-mcp/issues"
+  },
+  "homepage": "https://github.com/nishantmodak/tare-mcp#readme",
+  "files": [
+    "dist",
+    "examples",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "lint": "eslint src",
+    "format": "prettier --write src"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "cli",
+    "tokens",
+    "context"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "latest",
+    "commander": "latest",
+    "fast-glob": "latest",
+    "gpt-tokenizer": "latest",
+    "natural": "latest",
+    "picocolors": "latest",
+    "zod": "latest"
+  },
+  "devDependencies": {
+    "@eslint/js": "latest",
+    "@types/natural": "latest",
+    "@types/node": "latest",
+    "eslint": "latest",
+    "prettier": "latest",
+    "tsup": "latest",
+    "tsx": "latest",
+    "typescript": "latest",
+    "typescript-eslint": "latest",
+    "vitest": "latest"
+  }
+}