@gonzih/research-rabbit 0.1.0

package/dist/sources/semantic_scholar.js

@@ -0,0 +1,38 @@
+export async function searchSemanticScholar(query, limit = 10, yearFrom) {
+    const fields = 'paperId,title,authors,year,abstract,citationCount,externalIds,openAccessPdf';
+    let url = `https://api.semanticscholar.org/graph/v1/paper/search?query=${encodeURIComponent(query)}&fields=${fields}&limit=${limit}`;
+    if (yearFrom)
+        url += `&year=${yearFrom}-`;
+    try {
+        const response = await fetch(url, {
+            headers: {
+                'User-Agent': 'research-rabbit/0.1.0 (academic research tool)',
+            },
+            signal: AbortSignal.timeout(15000),
+        });
+        if (response.status === 429) {
+            console.error('Semantic Scholar rate limited');
+            return [];
+        }
+        if (!response.ok)
+            throw new Error(`Semantic Scholar API error: ${response.status}`);
+        const data = await response.json();
+        return (data.data || []).map(p => ({
+            id: `ss:${p.paperId}`,
+            source: 'semantic_scholar',
+            title: p.title || '',
+            authors: (p.authors || []).map(a => a.name),
+            year: p.year || 0,
+            abstract: p.abstract || '',
+            citationCount: p.citationCount ?? undefined,
+            doi: p.externalIds?.DOI,
+            url: `https://www.semanticscholar.org/paper/${p.paperId}`,
+            openAccessPdfUrl: p.openAccessPdf?.url,
+        }));
+    }
+    catch (error) {
+        console.error('Semantic Scholar search failed:', error instanceof Error ? error.message : error);
+        return [];
+    }
+}
+//# sourceMappingURL=semantic_scholar.js.map

package/dist/sources/semantic_scholar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic_scholar.js","sourceRoot":"","sources":["../../src/sources/semantic_scholar.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAa,EAAE,QAAgB,EAAE,EAAE,QAAiB;IAC9F,MAAM,MAAM,GAAG,6EAA6E,CAAC;IAC7F,IAAI,GAAG,GAAG,+DAA+D,kBAAkB,CAAC,KAAK,CAAC,WAAW,MAAM,UAAU,KAAK,EAAE,CAAC;IACrI,IAAI,QAAQ;QAAE,GAAG,IAAI,SAAS,QAAQ,GAAG,CAAC;IAE1C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,OAAO,EAAE;gBACP,YAAY,EAAE,gDAAgD;aAC/D;YACD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;SACnC,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;YAC/C,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAEpF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAsC,CAAC;QAEvE,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjC,EAAE,EAAE,MAAM,CAAC,CAAC,OAAO,EAAE;YACrB,MAAM,EAAE,kBAA2B;YACnC,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;YACpB,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC3C,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;YACjB,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE;YAC1B,aAAa,EAAE,CAAC,CAAC,aAAa,IAAI,SAAS;YAC3C,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG;YACvB,GAAG,EAAE,yCAAyC,CAAC,CAAC,OAAO,EAAE;YACzD,gBAAgB,EAAE,CAAC,CAAC,aAAa,EAAE,GAAG;SACvC,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACjG,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,51 @@
+export interface Paper {
+    id: string;
+    source: 'arxiv' | 'semantic_scholar' | 'openalex' | 'pubmed' | 'crossref';
+    title: string;
+    authors: string[];
+    year: number;
+    abstract: string;
+    citationCount?: number;
+    doi?: string;
+    url: string;
+    openAccessPdfUrl?: string;
+}
+export interface PaperSummary {
+    paperId: string;
+    title: string;
+    mainClaim: string;
+    methodology: string;
+    keyEvidence: string[];
+    limitations: string[];
+    relevanceToTopic: string;
+}
+export interface LiteratureMap {
+    consensus: string[];
+    debates: string[];
+    methodologicalTensions: string[];
+    temporalTrends: string[];
+}
+export interface Gap {
+    description: string;
+    type: 'population' | 'temporal' | 'methodological' | 'geographic' | 'theoretical' | 'other';
+    confidence: 'high' | 'medium' | 'low';
+    rationale: string;
+}
+export interface ArgumentScaffold {
+    thesisStatement: string;
+    supportingArguments: Array<{
+        claim: string;
+        evidence: string[];
+        paperIds: string[];
+    }>;
+    counterarguments: Array<{
+        claim: string;
+        rebuttal: string;
+        paperIds: string[];
+    }>;
+    suggestedStructure: string[];
+}
+export type CitationStyle = 'apa' | 'mla' | 'chicago';
+export type SearchSource = 'arxiv' | 'semantic_scholar' | 'openalex' | 'pubmed';
+export type SearchDepth = 'quick' | 'thorough';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,GAAG,kBAAkB,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,GAAG;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,YAAY,GAAG,UAAU,GAAG,gBAAgB,GAAG,YAAY,GAAG,aAAa,GAAG,OAAO,CAAC;IAC5F,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,KAAK,CAAC;QACzB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC,CAAC;IACH,gBAAgB,EAAE,KAAK,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC,CAAC;IACH,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,kBAAkB,GAAG,UAAU,GAAG,QAAQ,CAAC;AAChF,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,UAAU,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/llms.txt

@@ -0,0 +1,18 @@
+# research-rabbit
+
+MCP server for academic research. Searches ArXiv, Semantic Scholar, OpenAlex, and PubMed in parallel. Returns real papers with real abstracts. Never hallucinate citations.
+
+## Tools
+- search_papers: search multiple academic databases simultaneously
+- summarize_paper: structured summary from abstract (claim, method, evidence, limitations)
+- map_literature: identify consensus, debates, methodological tensions across papers
+- find_gaps: identify what's NOT being studied — where original contributions live
+- build_argument: scaffold a research argument with evidence from real papers
+- format_citation: APA, MLA, Chicago formatting from real paper metadata
+- search_and_summarize: all-in-one research assistant (search + summarize + map + gaps)
+
+## Principles
+- All papers come from real APIs
+- Gaps marked with confidence levels (high/medium/low)
+- Speculative analysis is labeled as such
+- Source URLs always included for verification

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@gonzih/research-rabbit",
+  "version": "0.1.0",
+  "description": "MCP server for student research — searches ArXiv, Semantic Scholar, OpenAlex, PubMed in parallel, maps literature, finds gaps, builds argument scaffolds",
+  "license": "MIT",
+  "author": "Gonzih",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "research-rabbit": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.54.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "llms.txt",
+    "SKILL.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}