阿奇夫-MCP

Name: 阿奇夫-MCP
Author: huanongfish

作者：huanongfish6 星标更新：2025-03-04

安装使用来源：spider==github.com

项目介绍

ArXiv MCP Server

🔍 使AI助手能够通过简单的MCP接口搜索并访问arXiv论文。

ArXiv MCP Server通过消息控制协议（MCP）在AI助手与arXiv的研究库之间提供了一个桥梁。它允许AI模型以编程方式搜索论文并访问其内容。

🤝 贡献 • 📝 报告错误

</div>

✨ 核心功能

🔎 论文搜索：使用日期范围和类别过滤器查询arXiv论文
📄 论文访问：下载并阅读论文内容
📋 论文列表：查看所有已下载的论文
🗃️ 本地存储：论文保存在本地以实现更快的访问
📝 提示：一组研究提示

🚀 快速开始

通过Smithery安装

要通过Smithery自动安装ArXiv Server for Claude Desktop：

npx -y @smithery/cli install arxiv-mcp-server --client claude

手动安装

使用uv进行安装：

uv tool install arxiv-mcp-server

对于开发：

# 克隆并设置开发环境
git clone https://github.com/blazickjp/arxiv-mcp-server.git
cd arxiv-mcp-server

# 创建并激活虚拟环境
uv venv
source .venv/bin/activate

# 安装测试依赖项
uv pip install -e ".[test]"

🔌 MCP集成

将此配置添加到您的MCP客户端配置文件中：

{
    "mcpServers": {
        "arxiv-mcp-server": {
            "command": "uv",
            "args": [
                "tool",
                "run",
                "arxiv-mcp-server",
                "--storage-path", "/path/to/paper/storage"
            ]
        }
    }
}

对于开发：

{
    "mcpServers": {
        "arxiv-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "path/to/cloned/arxiv-mcp-server",
                "run",
                "arxiv-mcp-server",
                "--storage-path", "/path/to/paper/storage"
            ]
        }
    }
}

💡 可用工具

服务器提供了四个主要工具：

1. 论文搜索

使用可选过滤器搜索论文：

result = await call_tool("search_papers", {
    "query": "transformer architecture",
    "max_results": 10,
    "date_from": "2023-01-01",
    "categories": ["cs.AI", "cs.LG"]
})

2. 论文下载

通过arXiv ID下载论文：

result = await call_tool("download_paper", {
    "paper_id": "2401.12345"
})

3. 列出论文

查看所有已下载的论文：

result = await call_tool("list_papers", {})

4. 阅读论文

访问已下载论文的内容：

result = await call_tool("read_paper", {
    "paper_id": "2401.12345"
})

⚙️ 配置

通过环境变量进行配置：

变量	目的	默认值
`ARXIV_STORAGE_PATH`	论文存储位置	~/.arxiv-mcp-server/papers

🧪 测试

运行测试套件：

python -m pytest

📄 许可证

根据MIT许可证发布。详情见LICENSE文件。

由Pear Labs团队制作 ❤️

</div>