@4da/mcp-server 3.2.0

package/README.md

@@ -0,0 +1,135 @@
+# @4da/mcp-server
+
+MCP server that plugs [4DA](https://github.com/4da-dev/4da-home)'s personalized developer intelligence into Claude Code, Cursor, Windsurf, or any MCP-compatible host.
+
+4DA monitors 11 sources (Hacker News, arXiv, Reddit, GitHub, Product Hunt, YouTube, etc.), scores everything against your codebase and tech stack, and rejects 99%+ as noise. This MCP server gives your AI tools access to what survived.
+
+## Quick Setup
+
+**Prerequisites:** [4DA](https://github.com/4da-dev/4da-home) must be installed and have run at least one analysis.
+
+### Claude Code
+
+```bash
+# Add to your project's .mcp.json
+claude mcp add 4da node /path/to/mcp-4da-server/dist/index.js
+```
+
+Or manually add to `.mcp.json`:
+```json
+{
+  "mcpServers": {
+    "4da": {
+      "command": "node",
+      "args": ["/path/to/mcp-4da-server/dist/index.js"],
+      "env": {
+        "FOURDA_DB_PATH": "/path/to/4da-v3/data/4da.db"
+      }
+    }
+  }
+}
+```
+
+### Cursor / Windsurf
+
+Add to `.cursor/mcp.json` or equivalent:
+```json
+{
+  "mcpServers": {
+    "4da": {
+      "command": "node",
+      "args": ["/path/to/mcp-4da-server/dist/index.js"],
+      "env": {
+        "FOURDA_DB_PATH": "/path/to/4da-v3/data/4da.db"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+```json
+{
+  "mcpServers": {
+    "4da": {
+      "command": "node",
+      "args": ["/path/to/mcp-4da-server/dist/index.js"],
+      "env": {
+        "FOURDA_DB_PATH": "/path/to/4da-v3/data/4da.db"
+      }
+    }
+  }
+}
+```
+
+## Tools (13)
+
+### Core
+
+| Tool | Description |
+|------|-------------|
+| `get_relevant_content` | Filtered content feed — only what passed the 5-axis scoring gate |
+| `get_context` | Your tech stack, interests, learned affinities, ACE-detected topics |
+| `explain_relevance` | Why a specific item was scored the way it was |
+| `record_feedback` | Teach 4DA — save, dismiss, or mark items irrelevant |
+
+### Intelligence
+
+| Tool | Description |
+|------|-------------|
+| `get_actionable_signals` | Classified signals: security alerts, breaking changes, new tools |
+| `daily_briefing` | Executive summary of recent discoveries (AI-powered with synthesize=true) |
+| `score_autopsy` | Forensic analysis of any item's scoring breakdown |
+| `trend_analysis` | Statistical patterns and anomaly detection across your feed |
+| `context_analysis` | Recommendations to optimize your context for better results |
+| `topic_connections` | Knowledge graph of how your content topics relate |
+
+### Diagnostic
+
+| Tool | Description |
+|------|-------------|
+| `source_health` | Pipeline status for each source adapter |
+| `config_validator` | Configuration validation and issue detection |
+| `llm_status` | LLM provider status and Ollama availability |
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `FOURDA_DB_PATH` | Path to 4DA's SQLite database | Auto-detected from `~/.4da/4da.db` or `data/4da.db` |
+
+## Build from Source
+
+```bash
+cd mcp-4da-server
+pnpm install
+pnpm build
+```
+
+## Test
+
+```bash
+# MCP Inspector (interactive)
+pnpm run inspect
+
+# Direct JSON-RPC
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/index.js
+```
+
+## Example Usage in Claude Code
+
+Once configured, you can ask Claude:
+
+- "What did 4DA find for me today?"
+- "Are there any security alerts in my feed?"
+- "Give me a briefing on what's relevant to my current project"
+- "Why was this item scored highly?"
+- "What are the trending topics in my domain?"
+
+Claude will use the MCP tools automatically to answer from your personalized feed.
+
+## License
+
+MIT

package/dist/db.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Database module for 4DA MCP Server
+ *
+ * Read-only access to the 4DA SQLite database.
+ * Only the record_feedback function performs writes.
+ */
+import Database from "better-sqlite3";
+import type { SourceItem, RelevantItem, UserContext, RelevanceExplanation, FeedbackAction, FeedbackResult } from "./types.js";
+/**
+ * 4DA Database accessor
+ */
+export declare class FourDADatabase {
+    private db;
+    constructor(dbPath?: string);
+    /**
+     * Get the raw better-sqlite3 database instance for custom queries
+     */
+    getRawDb(): Database.Database;
+    /**
+     * Close the database connection
+     */
+    close(): void;
+    /**
+     * Get relevant content items with computed relevance scores
+     */
+    getRelevantContent(minScore?: number, sourceType?: string, limit?: number, sinceHours?: number): RelevantItem[];
+    /**
+     * Get a single source item by ID and type
+     */
+    getSourceItem(itemId: number, sourceType: string): SourceItem | null;
+    /**
+     * Get the user's context (what 4DA knows about them)
+     */
+    getUserContext(includeAce?: boolean, includeLearned?: boolean): UserContext;
+    /**
+     * Explain why an item was considered relevant
+     */
+    explainRelevance(itemId: number, sourceType: string): RelevanceExplanation | null;
+    /**
+     * Record user feedback on an item
+     */
+    recordFeedback(itemId: number, sourceType: string, action: FeedbackAction): FeedbackResult;
+    /**
+     * Compute relevance score for an item based on user context
+     */
+    private computeRelevanceScore;
+    /**
+     * Extract topics from text (simple keyword extraction)
+     */
+    private extractTopics;
+    /**
+     * Check if a topic matches a term (case-insensitive, partial match)
+     */
+    private topicMatches;
+    /**
+     * Check if a word is a stop word
+     */
+    private isStopWord;
+}
+/**
+ * Create a database instance
+ */
+export declare function createDatabase(dbPath?: string): FourDADatabase;
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAStC,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EAMZ,WAAW,EAGX,oBAAoB,EACpB,cAAc,EACd,cAAc,EACf,MAAM,YAAY,CAAC;AAiEpB;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,CAAC,EAAE,MAAM;IAkB3B;;OAEG;IACH,QAAQ,IAAI,QAAQ,CAAC,QAAQ;IAI7B;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,kBAAkB,CAChB,QAAQ,GAAE,MAAa,EACvB,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,GAAE,MAAW,EAClB,UAAU,GAAE,MAAW,GACtB,YAAY,EAAE;IAiEjB;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAapE;;OAEG;IACH,cAAc,CAAC,UAAU,GAAE,OAAc,EAAE,cAAc,GAAE,OAAc,GAAG,WAAW;IA0GvF;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAsIjF;;OAEG;IACH,cAAc,CACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,GACrB,cAAc;IA2CjB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoE7B;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,UAAU;CA8FnB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,cAAc,CAE9D"}