概览

arXiv文件、元数据以及ArXiv API及其审调处-PMH元数据反馈的全文。 按查询、类别和提交日期来搜索文件;通过ID获取结构化元数据;并读取HTML和PDF制成的全纸文本,自动回落。 运行为 stdio 进程,本地可流的 HTTP 服务器,或上面的公共主机端点.

工具

资源

能力参考

arxiv_search_papers _工具

• 查询支持字段前缀 ti:, (中文(简体) ), au:, (中文(简体) ), abs:, (中文(简体) ), cat:, (中文(简体) ), co:, (中文(简体) ), jr:, (中文(简体) ), all: 财务报告和审定财务报表 AND 编号 : OR 编号 : ANDNOT,最多1000个字符; category 使用一个代码( e)cs.CL)或整个档案(astro-ph, (中文(简体) ), cs, (中文(简体) ), math(中文(简体) )
• 查询语法遵循 arXiv 的: 空间分隔的名词与 OR (写出) AND 以要求每个术语),运算符只是大写,所有三个词都有一个优先级归为右(a AND b OR c 实值 a AND (b OR c). 引文使用过时参数coauthors (帮助) 多字专题 (简体中文)"graph neural networks" AND cat:cs.LG)并在过滤器前加括号;arXiv 忽略了常见的单词,例如 of 财务报告和审定财务报表 the 引用的短语之外
• 排序为 sort_by (单位:千美元)relevance 编号 : submitted 编号 : updated,无论如何;arXiv自己的 submittedDate 编号 : lastUpdatedDate 改为 submitted 编号 : updated和 sort_order,与 submitted_from 编号 : submitted_to 包括世界协调时 YYYY-MM-DD 界限;每次呼叫最多50个结果(较大) max_results 返回 50时
• arXiv只服务于一个查询的第一个10,000个结果; a start 1万个失败 start_beyond_result_limit。使用日期窗口更进一步
• 输出回放有效的查询,总匹配计数,以及页面偏移;空页带回取回的指引而不是出错. 总共为一层(当地镜子计为5万) totalFoundIsLowerBound: true

arxiv_get_metadata _工具

• 最多需要100张身份证 查一下前10张 remaining_ids 下一个电话的 paper_ids。任何接受的拼写中重复的ID会被查一次,而不同版本的一张纸则分开
• 接受版本( E)2401.12345v2),未转录,以及2007年之前(hep-th/9901001身份证,可选 arXiv: 前缀或 arxiv.org abs 编号 : pdf 编号 : html 網址
• 返回已找到的纸外加打入的 not_found[] (单位:千美元)not_in_arxiv 编号 : version_not_in_mirror 编号 : version_not_served 编号 : live_lookup_failed 编号 : invalid_id其余部分; version_not_served arXiv 的 API 对 HTTP 500 的回答及其 detail 命名最新版本。 与当地的镜子, live_lookup_failed 标记一个识别符 镜像缺少其活视镜失败; 镜像服务的文件仍然回来
• 失败者 invalid_id 当没有很好的身份证, no_match 当每一个身份缺失, version_unavailable 当一个版本只能在活的 API 上达到时,并且 version_not_served 当每个ID是一个版本 arXiv 将不会服务

arxiv_read_paper _工具

• Tries arXiv HTML,然后是 ar5iv,然后是 PDF 文本提取 source 回答的实地报告。 PDF 文本是简单的, 因此数学、 表格和标题均匀
• ar5iv保留每张纸的一出出处,所以ar5iv的正文可能是另一种修改,而不是 paper_id 并携带 revision_unconfirmed: true,除非已读取的无版本和arXiv的API将v1报告为论文的唯一版本; pdf_url 准确的就是 paper_id 订正
• max_characters 默认为 100,000(通过) null 整页) start。第一页载有 outline 页:1
• paper_id 接受相同的 ID 拼写为 arxiv_get_metadata
• 失败者 invalid_id, (中文(简体) ), no_match (arXiv没有这种文件,或没有这种版本), content_unavailable (无渲染、无PDF), pdf_extraction_failed (PDF没有文本层或不解析), version_unavailable (arXiv是无法接触到的,当地镜像持有被钉住的ID的另一个版本),或 version_not_served (被取代的2007年前版本arXiv将不服务;命名最新版本和本版本的PDF)

arxiv_list_categories _工具

• ~155个类别,分布在8个最高级别的团体(cs, (中文(简体) ), econ, (中文(简体) ), eess, (中文(简体) ), math, (中文(简体) ), physics, (中文(简体) ), q-bio, (中文(简体) ), q-fin, (中文(简体) ), stat(中文(简体) )
• 可选 group 过滤到缩小结果
• 静态数据——总是成功的

arxiv://paper/{paperId} _资源

• paperId 接受相同的 ID 拼写为 arxiv_get_metadata; %-encode 一个遗留的ID的斜线(arxiv://paper/hep-th%2F9901001(中文(简体) )
• 失败者 empty_id, (中文(简体) ), invalid_id, (中文(简体) ), no_match, (中文(简体) ), version_unavailable,或 version_not_served

arxiv://categories _资源

• 回返 { categories: [...] },一个平面阵列,其中 code 编号 : name 编号 : group 每个条目
• 无参数;24h可缓存

特征

建造在 @cyanheads/mcp-ts-core: stdio和可流式的 HTTP 传输器,可插接式(none 编号 : jwt 编号 : oauth),可互换存储(in-memory, (中文(简体) ), filesystem, (中文(简体) ), Supabase, (中文(简体) ), Cloudflare KV/R2/D1),结构化记录,可选择的OpenTeleometry tracking.

arXiv 特异性:

• 只读, 不需要认证
• 请求队列执行 arXiv 的 三秒爬行延迟; 速率限制响应在冷却后迅速失败
• 纸张文本从 arXiv HTML 返回到 ar5iv 到 PDF 提取
• 作为静态数据嵌入的完整arXiv分类
• 可选的本地审调处-PMH元数据镜像(SQLite + FTS5)可以去除搜索和元数据的限速曝光. 见 可选: 本地镜像

方便代理输出 :

• arxiv_read_paper 名称 source· ; arxiv_search_papers 响应有效的查询
• arxiv_get_metadata 返回已输入的已找到的文档 not_found[] 每个错失的原因
• 类型 source 财务报告和审定财务报表 not_found[].reason enums 允许调用数据分支

开始

公共托管实例

可在 https://arxiv.caseyjhand.com/mcp 无需安装。 通过可流式HTTP将 MCP 客户端指向它 :

{
  "mcpServers": {
    "arxiv-mcp-server": {
      "type": "streamable-http",
      "url": "https://arxiv.caseyjhand.com/mcp"
    }
  }
}

自有/当地

在您的 MCP 客户端配置文件中添加以下内容 .

{
  "mcpServers": {
    "arxiv-mcp-server": {
      "type": "stdio",
      "command": "bunx",
      "args": ["@cyanheads/arxiv-mcp-server@latest"]
    }
  }
}

或者用 npx( 不需要 Bun) :

{
  "mcpServers": {
    "arxiv-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@cyanheads/arxiv-mcp-server@latest"]
    }
  }
}

或与道克相会:

{
  "mcpServers": {
    "arxiv-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "MCP_TRANSPORT_TYPE=stdio", "ghcr.io/cyanheads/arxiv-mcp-server:latest"]
    }
  }
}

对于可流式HTTP,设置传输并启动服务器:

MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 bun run start:http
# Server listens at http://localhost:3010/mcp

先决条件

• Bun v 1.4.4 (单位:千美元) 或更高(或Node.js v24+).

安装

1. 清除仓库 :

git clone https://github.com/cyanheads/arxiv-mcp-server.git

2. 导航到目录 :

cd arxiv-mcp-server

3. 安装依赖性 :

bun install

配置

所有配置都是可选的——服务器在框外工作,有合理的默认值.

见 .env.example 用于完整可选覆盖列表.

运行服务器

地方发展

• 构建和运行 :

  # One-time build
  bun run rebuild
  
  # Run the built server
  bun run start:http
  # or
  bun run start:stdio
  

• 运行检查和测试 :

  bun run devcheck   # Lint, format, typecheck, security audit
  bun run test       # Vitest test suite
  

可选: 本地镜像

对于一个Egress IP背后的自备部署,ARXIV的SQLite + FTS5 镜像可选 SQLite + FTS5 镜像服务 arxiv_search_papers 财务报告和审定财务报表 arxiv_get_metadata 本地,所以并行用户停止在arXiv的3秒爬行延迟后排队; arxiv_read_paper 仍可实时获取纸张文本。 收获一次 bun run mirror:init (~4.4h),然后设定 ARXIV_MIRROR_ENABLED=true。从 npm 安装、 调度更新、 计划升级中运行它, 且镜像搜索与 API 的活式搜索不同 文件/备忘录。 。 。 .

夹克

docker build -t arxiv-mcp-server .
docker run --rm -p 3010:3010 arxiv-mcp-server

Dockerfile 默认为 HTTP 传输、 无国籍会话模式和日志到 /var/log/arxiv-mcp-server。默认情况下安装了 OpenTeleometry 端端依赖性 --build-arg OTEL_ENABLED=false 以略去它们.

项目结构

发展指南

见 CLAUDE.md 发展准则和建筑规则。 简本:

• 搬运工投掷,框架渔获量——否 try/catch 在工具逻辑中
• 使用 ctx.log 请求范围伐木, ctx.state 租户范围储存
• arXiv API 返回 HTTP 200 , 包括速率限制, 因此在解析前检查内容类型和正文
• 验证原始 arXiv 响应 = 与域类型正常化 = 返回输出计划; 永远不编织缺失的字段

捐款

问题值得欢迎。 提交前运行检查 :

bun run devcheck
bun run test

许可证

阿帕奇-2.0 — 见 自由主义 详细情况.