mcp-server-research-signals 1.0.0

package/index.js

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+
+const { McpServer } = require("@modelcontextprotocol/sdk/server/mcp.js");
+const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
+const { z } = require("zod");
+const https = require("https");
+const http = require("http");
+
+// ── Config ──────────────────────────────────────────────────────────
+
+const API_KEY = process.env.MT_SIGNALS_API_KEY || "";
+const BASE_URL = (process.env.MT_SIGNALS_URL || "https://signals.metaltorque.dev").replace(/\/$/, "");
+
+// ── HTTP helper ─────────────────────────────────────────────────────
+
+function request(method, urlPath, body, timeout = 30000) {
+  return new Promise((resolve, reject) => {
+    const sep = urlPath.includes("?") ? "&" : "?";
+    const fullUrl = API_KEY ? `${BASE_URL}${urlPath}${sep}key=${API_KEY}` : `${BASE_URL}${urlPath}`;
+    const mod = fullUrl.startsWith("https") ? https : http;
+    const parsed = new URL(fullUrl);
+
+    const headers = {
+      "Content-Type": "application/json",
+      "User-Agent": "mcp-server-research-signals/1.0.0",
+    };
+
+    const opts = {
+      hostname: parsed.hostname,
+      port: parsed.port || (parsed.protocol === "https:" ? 443 : 80),
+      path: parsed.pathname + parsed.search,
+      method,
+      headers,
+      timeout,
+    };
+
+    const req = mod.request(opts, (res) => {
+      let data = "";
+      res.on("data", (c) => (data += c));
+      res.on("end", () => {
+        try {
+          const json = JSON.parse(data);
+          if (res.statusCode >= 400) return reject(new Error(json.error || `HTTP ${res.statusCode}`));
+          resolve(json);
+        } catch {
+          if (res.statusCode >= 400) return reject(new Error(`HTTP ${res.statusCode}: ${data.slice(0, 300)}`));
+          resolve(data);
+        }
+      });
+    });
+
+    req.on("error", reject);
+    req.on("timeout", () => { req.destroy(); reject(new Error("Request timed out")); });
+    if (body) req.write(JSON.stringify(body));
+    req.end();
+  });
+}
+
+// ── MCP Server ──────────────────────────────────────────────────────
+
+const server = new McpServer({
+  name: "research-signals",
+  version: "1.0.0",
+});
+
+// ── Tool: list_signals ──────────────────────────────────────────────
+
+server.tool(
+  "list_signals",
+  "List scored research signals from swarm intelligence. Each signal has a composite score based on urgency, buyer intent, durability, and source count. Signals come from HN, Reddit, ArXiv, GitHub, and other sources.",
+  {
+    category: z.string().optional().describe("Filter by category: ai, infrastructure, security, devtools, data, business, career, market"),
+    sort: z.string().optional().describe("Sort by: score (default), urgency, buyer_intent, durability"),
+    min_score: z.number().optional().describe("Minimum score filter"),
+    limit: z.number().default(25).describe("Max signals to return (default: 25)"),
+  },
+  async ({ category, sort, min_score, limit }) => {
+    const qs = [];
+    if (category) qs.push(`category=${encodeURIComponent(category)}`);
+    if (sort) qs.push(`sort=${sort}`);
+    if (min_score) qs.push(`min_score=${min_score}`);
+    if (limit) qs.push(`limit=${limit}`);
+    const query = qs.length > 0 ? `?${qs.join("&")}` : "";
+    const result = await request("GET", `/signals${query}`);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  }
+);
+
+// ── Tool: trending_signals ──────────────────────────────────────────
+
+server.tool(
+  "trending_signals",
+  "Get breakout signals (trending at 1.8x+ their rolling average) and hot signals (score 6+). Use this to find what's surging right now.",
+  {},
+  async () => {
+    const result = await request("GET", "/signals/trending");
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  }
+);
+
+// ── Tool: signal_detail ─────────────────────────────────────────────
+
+server.tool(
+  "signal_detail",
+  "Get deep detail on a specific research signal including full evidence, score breakdown (urgency, buyer intent, durability), actionable-for audience, and trend history.",
+  {
+    topic: z.string().describe("The signal topic to look up (partial match supported, use hyphens for spaces)"),
+  },
+  async ({ topic }) => {
+    const encoded = encodeURIComponent(topic.replace(/\s+/g, "-"));
+    const result = await request("GET", `/signals/${encoded}`);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  }
+);
+
+// ── Tool: signals_by_category ───────────────────────────────────────
+
+server.tool(
+  "signals_by_category",
+  "Get all signals in a specific category. Categories: ai, infrastructure, security, devtools, data, business, career, market.",
+  {
+    category: z.string().describe("Category name"),
+  },
+  async ({ category }) => {
+    const result = await request("GET", `/signals/category/${encodeURIComponent(category)}`);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  }
+);
+
+// ── Tool: signal_stats ──────────────────────────────────────────────
+
+server.tool(
+  "signal_stats",
+  "Get aggregate statistics: total signals, category breakdown (count + avg score + top topic per category), and the top 10 signals overall.",
+  {},
+  async () => {
+    const result = await request("GET", "/stats");
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  }
+);
+
+// ── Tool: recalculate_scores ────────────────────────────────────────
+
+server.tool(
+  "recalculate_scores",
+  "Force a recalculation of all signal scores. Applies time decay to urgency and detects new breakout trends. Use after ingesting new data.",
+  {},
+  async () => {
+    const result = await request("POST", "/trigger", { action: "recalculate" });
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  }
+);
+
+// ── Start ───────────────────────────────────────────────────────────
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch((e) => {
+  console.error("MCP server error:", e);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "mcp-server-research-signals",
+  "version": "1.0.0",
+  "description": "MCP server for research signal intelligence — scored trends from HN, Reddit, ArXiv, and GitHub.",
+  "bin": {
+    "mcp-server-research-signals": "index.js"
+  },
+  "keywords": ["mcp", "research", "signals", "trends", "market-intelligence", "model-context-protocol"],
+  "license": "MIT",
+  "author": "MetalTorque",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/joepangallo/research-signal-api"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "zod": "^3.23.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "index.js",
+    "README.md"
+  ]
+}