Arxiv Smart MCP

arXiv MCP服务器和速率限制代理

MCP服务器，用于搜索和阅读人工智能助手的arXiv论文-自我评分限制，以避免被arXiv API阻止。

为什么不是简单的MCP服务器？

arXiv API强制执行严格的费率限制。如果你超过了它们，你的IP就会被屏蔽。一个直接调用arXiv API的天真的MCP服务器无法抑制请求，而AI代理往往会快速连续地触发许多请求。

该项目通过将所有请求路由到自动执行速率限制的本地FastAPI代理来解决这个问题。你的AI助手可以调用任意数量的工具，而不会被禁止。

AI assistant  →  MCP server  →  FastAPI proxy (rate-limited)  →  arXiv API

工具

连接后，您的AI代理可以访问这些工具：

• 搜索路径 --通过带有排序选项的查询搜索arXiv
• get_paper --通过arXiv ID获取论文的完整元数据
• download_pdf --下载论文的PDF
• get_per_html --从ar5iv获取HTML渲染
• get_paper_markdown --对论文进行降价转换

设置

1.初始化并启动代理

just init
just start

必须运行代理才能使MCP工具工作。MCP服务器连接到上的代理 http://127.0.0.1:7171 默认情况下。

2.连接MCP服务器

将此粘贴到您的AI助手，并要求它添加此MCP服务器：

{
  "mcpServers": {
    "arxiv-smart": {
      "command": "npx",
      "args": ["tsx", "mcp/arxiv-smart.ts"],
      "cwd": "/path/to/arxiv-smart-mcp"
    }
  }
}

替换 /path/to/arxiv-smart-mcp 以及此存储库的实际路径。

配置

代理是通过以下方式配置的 config.yaml，它是由以下内容创建的 config.yaml.template 在...期间 just init.按键设置：

• 端口 --代理侦听端口（默认值：7171）
• 速率限制秒数 -arXiv API调用之间的最小间隔（默认值：3.0）
• request_timeout_seconds -arXiv API请求超时（默认值：30.0）

如果更改端口，请设置 REST_BASE MCP配置中的环境变量，以便MCP服务器可以找到代理：

{
  "mcpServers": {
    "arxiv-smart": {
      "command": "npx",
      "args": ["tsx", "mcp/arxiv-smart.ts"],
      "cwd": "/path/to/arxiv-smart-mcp",
      "env": {
        "REST_BASE": "http://127.0.0.1:7171"
      }
    }
  }
}

许可证

麻省理工学院