@fre4x/arxiv 1.0.1

package/README.md

@@ -0,0 +1,54 @@
+# arxiv — The Research Fang
+
+> *Knowledge is the only weapon that sharpens itself. This B1TE cuts through the noise.*
+
+Part of **[FRE4X-B1TE](../)** — a monorepo of MCP servers built for autonomous agents.
+
+Agents sleep while humans read. This server doesn't sleep. It hunts across the entire arXiv corpus — millions of papers, every category, in real time — so the agent always knows what humans don't yet.
+
+## Tools
+
+| Tool | What it hunts |
+|------|--------------|
+| `arxiv_search` | Free-text search with field prefixes (`ti:`, `au:`, `abs:`, `cat:`) and boolean operators |
+| `arxiv_get_paper` | Full metadata for one or more papers by arXiv ID |
+| `arxiv_search_by_author` | All papers by a specific author |
+| `arxiv_search_by_category` | Papers in a subject category (e.g. `cs.AI`, `cs.LG`, `q-fin.TR`) |
+| `arxiv_list_categories` | All supported arXiv subject categories |
+
+## Query Syntax
+
+```
+ti:attention AND cat:cs.LG
+au:Bengio AND abs:generalization
+cat:cs.CV AND ti:object detection
+ti:diffusion AND NOT abs:image
+```
+
+All list tools support `limit` (max 100) and `offset` for pagination.  
+All tools support `response_format: "markdown"` (default) or `"json"`.
+
+## Deploy
+
+```json
+{
+  "mcpServers": {
+    "arxiv": {
+      "command": "npx",
+      "args": ["-y", "@fre4x/arxiv"]
+    }
+  }
+}
+```
+
+## Development
+
+```bash
+bun install
+bun run dev      # tsx, no build
+bun run build    # compile → dist/
+```
+
+## License
+
+MIT — **WE ARE THE FRE4X.**

package/dist/api.d.ts

@@ -0,0 +1,14 @@
+import { ArxivSearchResult, SortBy, SortOrder } from "./types.js";
+export interface SearchParams {
+    query: string;
+    start?: number;
+    maxResults?: number;
+    sortBy?: SortBy;
+    sortOrder?: SortOrder;
+}
+export declare class ArxivApiClient {
+    search(params: SearchParams): Promise<ArxivSearchResult>;
+    getById(ids: string[]): Promise<ArxivSearchResult>;
+    private parseResponse;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,iBAAiB,EAIjB,MAAM,EACN,SAAS,EACV,MAAM,YAAY,CAAC;AAqEpB,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,qBAAa,cAAc;IACnB,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiBxD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAYxD,OAAO,CAAC,aAAa;CAsBtB"}

package/dist/api.js

@@ -0,0 +1,96 @@
+import axios from "axios";
+import { XMLParser } from "fast-xml-parser";
+import { SortBy, SortOrder, } from "./types.js";
+const BASE_URL = "https://export.arxiv.org/api/query";
+const parser = new XMLParser({
+    ignoreAttributes: false,
+    attributeNamePrefix: "@_",
+    isArray: (tagName) => ["entry", "author", "category", "link"].includes(tagName),
+});
+function extractArxivId(fullId) {
+    // arXiv IDs look like: http://arxiv.org/abs/2301.00001v1
+    const match = fullId.match(/abs\/([^v]+)/);
+    return match ? match[1] : fullId;
+}
+function parsePaper(entry) {
+    const rawAuthors = entry["author"] ?? [];
+    const authors = rawAuthors.map((a) => ({
+        name: String(a["name"] ?? ""),
+    }));
+    const rawCategories = entry["category"] ?? [];
+    const categories = rawCategories.map((c) => ({
+        term: String(c["@_term"] ?? ""),
+        scheme: c["@_scheme"],
+        label: c["@_label"],
+    }));
+    const rawLinks = entry["link"] ?? [];
+    const links = rawLinks.map((l) => ({
+        href: String(l["@_href"] ?? ""),
+        rel: l["@_rel"],
+        type: l["@_type"],
+        title: l["@_title"],
+    }));
+    const pdfLink = links.find((l) => l.title === "pdf" || l.type === "application/pdf");
+    const pdfUrl = pdfLink?.href;
+    const primaryCategoryRaw = entry["arxiv:primary_category"];
+    const primaryCategory = primaryCategoryRaw
+        ? {
+            term: String(primaryCategoryRaw["@_term"] ?? ""),
+            scheme: primaryCategoryRaw["@_scheme"],
+        }
+        : undefined;
+    const fullId = String(entry["id"] ?? "");
+    return {
+        id: fullId,
+        arxivId: extractArxivId(fullId),
+        title: String(entry["title"] ?? "").replace(/\s+/g, " ").trim(),
+        summary: String(entry["summary"] ?? "").replace(/\s+/g, " ").trim(),
+        authors,
+        categories,
+        primaryCategory,
+        published: String(entry["published"] ?? ""),
+        updated: String(entry["updated"] ?? ""),
+        links,
+        pdfUrl,
+        doi: entry["arxiv:doi"],
+        journalRef: entry["arxiv:journal_ref"],
+        comment: entry["arxiv:comment"],
+    };
+}
+export class ArxivApiClient {
+    async search(params) {
+        const { query, start = 0, maxResults = 10, sortBy = SortBy.RELEVANCE, sortOrder = SortOrder.DESCENDING } = params;
+        const response = await axios.get(BASE_URL, {
+            params: {
+                search_query: query,
+                start,
+                max_results: maxResults,
+                sortBy,
+                sortOrder,
+            },
+            timeout: 30000,
+        });
+        return this.parseResponse(response.data);
+    }
+    async getById(ids) {
+        const response = await axios.get(BASE_URL, {
+            params: {
+                id_list: ids.join(","),
+                max_results: ids.length,
+            },
+            timeout: 30000,
+        });
+        return this.parseResponse(response.data);
+    }
+    parseResponse(xml) {
+        const parsed = parser.parse(xml);
+        const feed = parsed["feed"];
+        const totalResults = parseInt(String(feed["opensearch:totalResults"]?.["#text"] ?? feed["opensearch:totalResults"] ?? "0"), 10);
+        const startIndex = parseInt(String(feed["opensearch:startIndex"]?.["#text"] ?? feed["opensearch:startIndex"] ?? "0"), 10);
+        const itemsPerPage = parseInt(String(feed["opensearch:itemsPerPage"]?.["#text"] ?? feed["opensearch:itemsPerPage"] ?? "0"), 10);
+        const rawEntries = feed["entry"] ?? [];
+        const papers = rawEntries.map(parsePaper);
+        return { totalResults, startIndex, itemsPerPage, papers };
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,251 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { ArxivApiClient } from "./api.js";
+import { ResponseFormat, SortBy, SortOrder, ARXIV_CATEGORIES } from "./types.js";
+const api = new ArxivApiClient();
+const server = new McpServer({
+    name: "arxiv-mcp-server",
+    version: "1.0.0",
+});
+const CHARACTER_LIMIT = 50000;
+// ─── Formatting helpers ────────────────────────────────────────────────────────
+function formatPaperMarkdown(paper) {
+    const lines = [];
+    lines.push(`## ${paper.title}`);
+    lines.push(`**arXiv ID**: [${paper.arxivId}](https://arxiv.org/abs/${paper.arxivId})`);
+    lines.push(`**Authors**: ${paper.authors.map((a) => a.name).join(", ")}`);
+    lines.push(`**Published**: ${paper.published.split("T")[0]}`);
+    if (paper.updated !== paper.published) {
+        lines.push(`**Updated**: ${paper.updated.split("T")[0]}`);
+    }
+    const cats = paper.categories.map((c) => {
+        const label = ARXIV_CATEGORIES[c.term];
+        return label ? `${c.term} (${label})` : c.term;
+    });
+    lines.push(`**Categories**: ${cats.join(", ")}`);
+    if (paper.doi)
+        lines.push(`**DOI**: ${paper.doi}`);
+    if (paper.journalRef)
+        lines.push(`**Journal**: ${paper.journalRef}`);
+    if (paper.pdfUrl)
+        lines.push(`**PDF**: ${paper.pdfUrl}`);
+    if (paper.comment)
+        lines.push(`**Comment**: ${paper.comment}`);
+    lines.push(`\n### Abstract\n\n${paper.summary}`);
+    return lines.join("\n");
+}
+function formatPaperListMarkdown(papers, total, start) {
+    const lines = [];
+    lines.push(`# arXiv Search Results\n`);
+    lines.push(`Showing ${papers.length} of ${total} results (offset: ${start})\n`);
+    papers.forEach((paper, i) => {
+        lines.push(`### ${i + 1 + start}. ${paper.title}`);
+        lines.push(`**arXiv**: [${paper.arxivId}](https://arxiv.org/abs/${paper.arxivId}) | ` +
+            `**Authors**: ${paper.authors.slice(0, 3).map((a) => a.name).join(", ")}${paper.authors.length > 3 ? " et al." : ""}`);
+        lines.push(`**Published**: ${paper.published.split("T")[0]} | ` +
+            `**Category**: ${paper.primaryCategory?.term ?? paper.categories[0]?.term ?? "N/A"}`);
+        lines.push(`> ${paper.summary.substring(0, 300)}${paper.summary.length > 300 ? "..." : ""}`);
+        lines.push("");
+    });
+    if (total > start + papers.length) {
+        lines.push(`*${total - start - papers.length} more results available. Use \`offset=${start + papers.length}\` to continue.*`);
+    }
+    return lines.join("\n");
+}
+function truncate(content) {
+    if (content.length <= CHARACTER_LIMIT)
+        return content;
+    return content.substring(0, CHARACTER_LIMIT) +
+        "\n\n> Content truncated due to size limit. Use pagination to fetch more.";
+}
+// ─── Shared schemas ────────────────────────────────────────────────────────────
+const paginationSchema = {
+    limit: z.number().int().min(1).max(100).default(10).describe("Number of results to return (max 100)"),
+    offset: z.number().int().min(0).default(0).describe("Offset for pagination"),
+};
+const sortSchema = {
+    sort_by: z.nativeEnum(SortBy).default(SortBy.RELEVANCE).describe("Sort field: relevance | lastUpdatedDate | submittedDate"),
+    sort_order: z.nativeEnum(SortOrder).default(SortOrder.DESCENDING).describe("Sort order: ascending | descending"),
+};
+const responseFormatSchema = {
+    response_format: z
+        .nativeEnum(ResponseFormat)
+        .default(ResponseFormat.MARKDOWN)
+        .describe("Output format: markdown or json"),
+};
+// ─── Tool: arxiv_search ────────────────────────────────────────────────────────
+server.registerTool("arxiv_search", {
+    title: "Search arXiv Papers",
+    description: "Search arXiv for academic papers using a free-text query. Supports boolean operators (AND, OR, NOT), " +
+        "field prefixes (ti: title, au: author, abs: abstract, cat: category, all:), " +
+        "e.g. 'ti:transformer AND cat:cs.LG'.",
+    inputSchema: z.object({
+        query: z.string().describe("Search query. May include arXiv field prefixes: ti:(title), au:(author), abs:(abstract), " +
+            "cat:(category), all:(any field). Supports AND/OR/NOT operators."),
+        ...paginationSchema,
+        ...sortSchema,
+        ...responseFormatSchema,
+    }),
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+}, async (params) => {
+    const result = await api.search({
+        query: params.query,
+        start: params.offset,
+        maxResults: params.limit,
+        sortBy: params.sort_by,
+        sortOrder: params.sort_order,
+    });
+    if (params.response_format === ResponseFormat.JSON) {
+        return {
+            content: [{ type: "text", text: truncate(JSON.stringify(result, null, 2)) }],
+            structuredContent: result,
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: truncate(formatPaperListMarkdown(result.papers, result.totalResults, result.startIndex)),
+            },
+        ],
+    };
+});
+// ─── Tool: arxiv_get_paper ─────────────────────────────────────────────────────
+server.registerTool("arxiv_get_paper", {
+    title: "Get arXiv Paper Details",
+    description: "Retrieve full details for one or more arXiv papers by their IDs (e.g. '2301.00001' or '2301.00001v2'). " +
+        "Returns title, authors, abstract, categories, PDF link, DOI, and journal reference.",
+    inputSchema: z.object({
+        ids: z
+            .array(z.string())
+            .min(1)
+            .max(20)
+            .describe("List of arXiv paper IDs (e.g. ['2301.00001', '1706.03762'])"),
+        ...responseFormatSchema,
+    }),
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+}, async (params) => {
+    const result = await api.getById(params.ids);
+    if (result.papers.length === 0) {
+        return { content: [{ type: "text", text: "No papers found for the given IDs." }] };
+    }
+    if (params.response_format === ResponseFormat.JSON) {
+        return {
+            content: [{ type: "text", text: truncate(JSON.stringify(result.papers, null, 2)) }],
+            structuredContent: { papers: result.papers },
+        };
+    }
+    const markdown = result.papers.map(formatPaperMarkdown).join("\n\n---\n\n");
+    return { content: [{ type: "text", text: truncate(markdown) }] };
+});
+// ─── Tool: arxiv_search_by_author ─────────────────────────────────────────────
+server.registerTool("arxiv_search_by_author", {
+    title: "Search arXiv Papers by Author",
+    description: "Search arXiv for papers by a specific author name.",
+    inputSchema: z.object({
+        author: z.string().describe("Author name to search for (e.g. 'Yann LeCun', 'Hinton')"),
+        ...paginationSchema,
+        ...sortSchema,
+        ...responseFormatSchema,
+    }),
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+}, async (params) => {
+    const result = await api.search({
+        query: `au:${params.author}`,
+        start: params.offset,
+        maxResults: params.limit,
+        sortBy: params.sort_by,
+        sortOrder: params.sort_order,
+    });
+    if (params.response_format === ResponseFormat.JSON) {
+        return {
+            content: [{ type: "text", text: truncate(JSON.stringify(result, null, 2)) }],
+            structuredContent: result,
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: truncate(formatPaperListMarkdown(result.papers, result.totalResults, result.startIndex)),
+            },
+        ],
+    };
+});
+// ─── Tool: arxiv_search_by_category ───────────────────────────────────────────
+server.registerTool("arxiv_search_by_category", {
+    title: "Search arXiv Papers by Category",
+    description: "Browse or search papers within a specific arXiv subject category " +
+        "(e.g. cs.AI, cs.LG, cs.CV, stat.ML, quant-ph). Use arxiv_list_categories to see all available categories.",
+    inputSchema: z.object({
+        category: z
+            .string()
+            .describe("arXiv category code (e.g. 'cs.AI', 'cs.LG', 'stat.ML', 'quant-ph')"),
+        query: z
+            .string()
+            .optional()
+            .describe("Optional additional search query to filter within the category"),
+        ...paginationSchema,
+        sort_by: z.nativeEnum(SortBy).default(SortBy.SUBMITTED).describe("Sort field: relevance | lastUpdatedDate | submittedDate"),
+        sort_order: z.nativeEnum(SortOrder).default(SortOrder.DESCENDING).describe("Sort order: ascending | descending"),
+        ...responseFormatSchema,
+    }),
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+}, async (params) => {
+    const queryParts = [`cat:${params.category}`];
+    if (params.query)
+        queryParts.push(`AND all:${params.query}`);
+    const result = await api.search({
+        query: queryParts.join(" "),
+        start: params.offset,
+        maxResults: params.limit,
+        sortBy: params.sort_by,
+        sortOrder: params.sort_order,
+    });
+    if (params.response_format === ResponseFormat.JSON) {
+        return {
+            content: [{ type: "text", text: truncate(JSON.stringify(result, null, 2)) }],
+            structuredContent: result,
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: truncate(formatPaperListMarkdown(result.papers, result.totalResults, result.startIndex)),
+            },
+        ],
+    };
+});
+// ─── Tool: arxiv_list_categories ──────────────────────────────────────────────
+server.registerTool("arxiv_list_categories", {
+    title: "List arXiv Subject Categories",
+    description: "List the commonly used arXiv subject categories with their descriptions.",
+    inputSchema: z.object({}),
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+}, async () => {
+    const lines = ["# arXiv Subject Categories\n"];
+    let currentGroup = "";
+    for (const [code, label] of Object.entries(ARXIV_CATEGORIES)) {
+        const group = code.split(".")[0];
+        if (group !== currentGroup) {
+            lines.push(`\n## ${group.toUpperCase()}\n`);
+            currentGroup = group;
+        }
+        lines.push(`- **${code}** — ${label}`);
+    }
+    return { content: [{ type: "text", text: lines.join("\n") }] };
+});
+// ─── Start server ──────────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("arXiv MCP server running on stdio");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,52 @@
+export interface ArxivAuthor {
+    name: string;
+}
+export interface ArxivCategory {
+    term: string;
+    scheme?: string;
+    label?: string;
+}
+export interface ArxivLink {
+    href: string;
+    rel?: string;
+    type?: string;
+    title?: string;
+}
+export interface ArxivPaper {
+    id: string;
+    arxivId: string;
+    title: string;
+    summary: string;
+    authors: ArxivAuthor[];
+    categories: ArxivCategory[];
+    primaryCategory?: ArxivCategory;
+    published: string;
+    updated: string;
+    links: ArxivLink[];
+    pdfUrl?: string;
+    doi?: string;
+    journalRef?: string;
+    comment?: string;
+}
+export interface ArxivSearchResult {
+    totalResults: number;
+    startIndex: number;
+    itemsPerPage: number;
+    papers: ArxivPaper[];
+}
+export declare enum SortBy {
+    RELEVANCE = "relevance",
+    LAST_UPDATED = "lastUpdatedDate",
+    SUBMITTED = "submittedDate"
+}
+export declare enum SortOrder {
+    ASCENDING = "ascending",
+    DESCENDING = "descending"
+}
+export declare enum ResponseFormat {
+    MARKDOWN = "markdown",
+    JSON = "json"
+}
+/** Major arXiv subject categories with friendly names */
+export declare const ARXIV_CATEGORIES: Record<string, string>;
+//# 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,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,eAAe,CAAC,EAAE,aAAa,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,oBAAY,MAAM;IAChB,SAAS,cAAc;IACvB,YAAY,oBAAoB;IAChC,SAAS,kBAAkB;CAC5B;AAED,oBAAY,SAAS;IACnB,SAAS,cAAc;IACvB,UAAU,eAAe;CAC1B;AAED,oBAAY,cAAc;IACxB,QAAQ,aAAa;IACrB,IAAI,SAAS;CACd;AAED,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmCnD,CAAC"}

package/dist/types.js

@@ -0,0 +1,54 @@
+export var SortBy;
+(function (SortBy) {
+    SortBy["RELEVANCE"] = "relevance";
+    SortBy["LAST_UPDATED"] = "lastUpdatedDate";
+    SortBy["SUBMITTED"] = "submittedDate";
+})(SortBy || (SortBy = {}));
+export var SortOrder;
+(function (SortOrder) {
+    SortOrder["ASCENDING"] = "ascending";
+    SortOrder["DESCENDING"] = "descending";
+})(SortOrder || (SortOrder = {}));
+export var ResponseFormat;
+(function (ResponseFormat) {
+    ResponseFormat["MARKDOWN"] = "markdown";
+    ResponseFormat["JSON"] = "json";
+})(ResponseFormat || (ResponseFormat = {}));
+/** Major arXiv subject categories with friendly names */
+export const ARXIV_CATEGORIES = {
+    // Computer Science
+    "cs.AI": "Artificial Intelligence",
+    "cs.CL": "Computation and Language (NLP)",
+    "cs.CV": "Computer Vision and Pattern Recognition",
+    "cs.LG": "Machine Learning",
+    "cs.NE": "Neural and Evolutionary Computing",
+    "cs.RO": "Robotics",
+    "cs.CR": "Cryptography and Security",
+    "cs.DS": "Data Structures and Algorithms",
+    "cs.DC": "Distributed, Parallel, and Cluster Computing",
+    "cs.SE": "Software Engineering",
+    "cs.DB": "Databases",
+    "cs.IR": "Information Retrieval",
+    "cs.PL": "Programming Languages",
+    "cs.SY": "Systems and Control",
+    // Mathematics
+    "math.ST": "Statistics Theory",
+    "math.PR": "Probability",
+    "math.CO": "Combinatorics",
+    "math.OC": "Optimization and Control",
+    // Statistics
+    "stat.ML": "Machine Learning (Statistics)",
+    "stat.AP": "Applications",
+    "stat.CO": "Computation",
+    // Physics
+    "physics.comp-ph": "Computational Physics",
+    "quant-ph": "Quantum Physics",
+    "hep-th": "High Energy Physics (Theory)",
+    // Biology
+    "q-bio.NC": "Neurons and Cognition",
+    "q-bio.QM": "Quantitative Methods",
+    // Economics
+    "econ.ML": "Econometrics (ML)",
+    "econ.GN": "General Economics",
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAyCA,MAAM,CAAN,IAAY,MAIX;AAJD,WAAY,MAAM;IAChB,iCAAuB,CAAA;IACvB,0CAAgC,CAAA;IAChC,qCAA2B,CAAA;AAC7B,CAAC,EAJW,MAAM,KAAN,MAAM,QAIjB;AAED,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,oCAAuB,CAAA;IACvB,sCAAyB,CAAA;AAC3B,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AAED,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,uCAAqB,CAAA;IACrB,+BAAa,CAAA;AACf,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAED,yDAAyD;AACzD,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,mBAAmB;IACnB,OAAO,EAAE,yBAAyB;IAClC,OAAO,EAAE,gCAAgC;IACzC,OAAO,EAAE,yCAAyC;IAClD,OAAO,EAAE,kBAAkB;IAC3B,OAAO,EAAE,mCAAmC;IAC5C,OAAO,EAAE,UAAU;IACnB,OAAO,EAAE,2BAA2B;IACpC,OAAO,EAAE,gCAAgC;IACzC,OAAO,EAAE,8CAA8C;IACvD,OAAO,EAAE,sBAAsB;IAC/B,OAAO,EAAE,WAAW;IACpB,OAAO,EAAE,uBAAuB;IAChC,OAAO,EAAE,uBAAuB;IAChC,OAAO,EAAE,qBAAqB;IAC9B,cAAc;IACd,SAAS,EAAE,mBAAmB;IAC9B,SAAS,EAAE,aAAa;IACxB,SAAS,EAAE,eAAe;IAC1B,SAAS,EAAE,0BAA0B;IACrC,aAAa;IACb,SAAS,EAAE,+BAA+B;IAC1C,SAAS,EAAE,cAAc;IACzB,SAAS,EAAE,aAAa;IACxB,UAAU;IACV,iBAAiB,EAAE,uBAAuB;IAC1C,UAAU,EAAE,iBAAiB;IAC7B,QAAQ,EAAE,8BAA8B;IACxC,UAAU;IACV,UAAU,EAAE,uBAAuB;IACnC,UAAU,EAAE,sBAAsB;IAClC,YAAY;IACZ,SAAS,EAAE,mBAAmB;IAC9B,SAAS,EAAE,mBAAmB;CAC/B,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@fre4x/arxiv",
+  "version": "1.0.1",
+  "description": "An arXiv MCP server for searching and retrieving academic papers.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "arxiv": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "watch": "tsc -w"
+  },
+  "keywords": [
+    "mcp",
+    "arxiv",
+    "mcp-server",
+    "research",
+    "papers",
+    "ai"
+  ],
+  "author": "fritzprix",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "axios": "^1.13.5",
+    "fast-xml-parser": "^4.5.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}