twittertools-mcp 1.0.2 → 1.1.1

package/README.md

@@ -20,6 +20,10 @@ API, which resolves public posts through X's free syndication endpoint. The othe
 three run entirely offline. Media is **not** proxied: tweet results carry the
 direct `pbs.twimg.com` / `video.twimg.com` URLs, which any client can fetch on its own.
 
+The package has **zero dependencies**: the MCP protocol layer is hand-rolled
+(line-delimited JSON-RPC over stdio), so the entire supply-chain surface is the
+couple hundred lines in this directory — verifiable against Socket or any scanner.
+
 ## Install
 
 ```sh
@@ -43,6 +47,10 @@ Or add it to any client that reads an `mcpServers` config
 
 Requires Node 18+.
 
+> Tip: `npx` resolves the latest version from the registry on every launch
+> (instant once cached, a few seconds the very first time). For zero startup
+> delay, `npm i -g twittertools-mcp` once and set `"command": "twittertools-mcp"`.
+
 ## Self-hosting
 
 Point `TWITTERTOOLS_API_BASE` at your own instance of

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twittertools-mcp",
-  "version": "1.0.2",
+  "version": "1.1.1",
   "mcpName": "io.github.steley/twittertools-mcp",
   "description": "MCP server for twittertools.com — fetch X (Twitter) posts and threads, count and split posts with X's real rules. No login, no tracking.",
   "license": "MIT",
@@ -33,8 +33,5 @@
   "bugs": "https://github.com/steley/twittertools/issues",
   "scripts": {
     "start": "node server.js"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0"
   }
 }

package/server.js

@@ -12,11 +12,14 @@
  * direct pbs.twimg.com / video.twimg.com URLs, which any client can fetch.
  *
  * Set TWITTERTOOLS_API_BASE to point at a self-hosted instance.
+ *
+ * The MCP protocol layer below is hand-rolled on purpose: the official SDK
+ * pulls an HTTP-server dependency tree (express, hono, ajv, cross-spawn, …)
+ * into a stdio-only package. A tools-only server needs exactly four verbs,
+ * implemented against the line-delimited JSON-RPC 2.0 framing of the MCP
+ * stdio transport — pinned by the vitest suite in test/.
  */
 
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { ListToolsRequestSchema, CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import {
   countTweet,
   splitThread,
@@ -26,9 +29,9 @@ import {
 } from "./xrules.js";
 
 const NAME = "twittertools";
-const VERSION = "1.0.2"; // keep in sync with package.json
+const VERSION = "1.1.1"; // keep in sync with package.json
 const API_BASE = (process.env.TWITTERTOOLS_API_BASE || "https://twittertools.com").replace(/\/+$/, "");
-const ATTRIBUTION = "\n\nvia twittertools.com";
+const VIA = "https://twittertools.com";
 const TEXT_INPUT_MAX = 100_000; // generous, but caps local work per call
 
 const urlOrIdSchema = {
@@ -149,15 +152,17 @@ async function callTool(name, args) {
     case "get_tweet": {
       const data = await callApi("tweet", { id: strArg(args, "url_or_id") });
       if (!data?.tweet) throw new Error("twittertools API returned no tweet");
-      return textResult(JSON.stringify(data.tweet, null, 2) + ATTRIBUTION);
+      // attribution rides inside the JSON: clients that pretty-render tool
+      // results would strip a trailing signature line appended after it
+      return textResult(JSON.stringify({ tweet: data.tweet, via: VIA }, null, 2));
     }
     case "get_thread": {
       const data = await callApi("thread", { url: strArg(args, "url_or_id") });
       if (!data?.tweets) throw new Error("twittertools API returned no thread");
-      const head = data?.partial
+      const head = data.partial
         ? `Note: this thread result is PARTIAL (${data.reason || "incomplete"}) — posts may be missing.\n\n`
         : "";
-      return textResult(head + JSON.stringify({ count: data.tweets.length, tweets: data.tweets }, null, 2) + ATTRIBUTION);
+      return textResult(head + JSON.stringify({ count: data.tweets.length, tweets: data.tweets, via: VIA }, null, 2));
     }
     case "count_chars":
       return textResult(JSON.stringify(countTweet(strArg(args, "text", TEXT_INPUT_MAX)), null, 2));
@@ -190,17 +195,85 @@ async function callTool(name, args) {
   }
 }
 
-const server = new Server({ name: NAME, version: VERSION }, { capabilities: { tools: {} } });
+// --------------------------------------------------------------------------- //
+// Line-delimited JSON-RPC 2.0 over stdio (MCP stdio transport)                 //
+// --------------------------------------------------------------------------- //
+
+function send(msg) {
+  process.stdout.write(JSON.stringify(msg) + "\n");
+}
 
-server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+function sendResult(id, result) {
+  send({ jsonrpc: "2.0", id, result });
+}
 
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-  const { name, arguments: args } = request.params;
+function sendError(id, code, message) {
+  send({ jsonrpc: "2.0", id, error: { code, message } });
+}
+
+async function dispatch(msg) {
+  const { method, id, params } = msg;
+  const isRequest = "id" in msg;
   try {
-    return await callTool(name, args);
+    switch (method) {
+      case "initialize":
+        // echo the client's requested version: every current client accepts
+        // its own, and we make no use of newer protocol features
+        sendResult(id, {
+          protocolVersion: params?.protocolVersion || "2024-11-05",
+          capabilities: { tools: {} },
+          serverInfo: { name: NAME, version: VERSION },
+        });
+        return;
+      case "notifications/initialized":
+        return; // notification — no response
+      case "tools/list":
+        sendResult(id, { tools: TOOLS });
+        return;
+      case "tools/call":
+        // tool execution failures are tool results (isError), not protocol
+        // errors — matches how every client renders a failed tool call
+        try {
+          sendResult(id, await callTool(params?.name, params?.arguments));
+        } catch (e) {
+          sendResult(id, textResult(`Error: ${e?.message || String(e)}`, { error: true }));
+        }
+        return;
+      case "ping":
+        sendResult(id, {});
+        return;
+      default:
+        // unknown notifications are silently ignored per JSON-RPC 2.0
+        if (isRequest) sendError(id, -32601, `Method not found: ${method}`);
+    }
   } catch (e) {
-    return textResult(`Error: ${e?.message || String(e)}`, { error: true });
+    if (isRequest) sendError(id, -32603, `Internal error: ${e?.message || String(e)}`);
   }
-});
+}
 
-await server.connect(new StdioServerTransport());
+let buffer = "";
+process.stdin.setEncoding("utf8");
+process.stdin.on("data", (chunk) => {
+  buffer += chunk;
+  let i;
+  while ((i = buffer.indexOf("\n")) >= 0) {
+    const line = buffer.slice(0, i).trim();
+    buffer = buffer.slice(i + 1);
+    if (!line) continue;
+    let msg;
+    try {
+      msg = JSON.parse(line);
+    } catch {
+      sendError(null, -32700, "Parse error");
+      continue;
+    }
+    if (!msg || typeof msg !== "object" || typeof msg.method !== "string") {
+      if (msg && typeof msg === "object" && "id" in msg) {
+        sendError(msg.id, -32600, "Invalid Request");
+      }
+      continue;
+    }
+    dispatch(msg);
+  }
+});
+process.stdin.on("end", () => process.exit(0));