ArXiv MCP Server

ArXiv MCP Server

🔍 Permita que assistentes de IA pesquisem e acessem artigos do arXiv por meio de uma interface MCP simples.

O ArXiv MCP Server fornece uma ponte entre assistentes de IA e o repositório de pesquisa do arXiv por meio do Message Control Protocol (MCP). Ele permite que modelos de IA pesquisem artigos e acessem seu conteúdo de forma programática.

✨ Recursos Principais

• 🔎 Pesquisa de Artigos: Consulte artigos do arXiv com filtros para intervalos de datas e categorias
• 📄 Acesso a Artigos: Baixe e leia o conteúdo dos artigos
• 📋 Listagem de Artigos: Visualize todos os artigos baixados
• 🗃️ Armazenamento Local: Artigos são salvos localmente para acesso mais rápido
• 📝 Prompts: Um Conjunto de Prompts de Pesquisa

🚀 Início Rápido

Instalação via Smithery

Para instalar o ArXiv Server para Claude Desktop automaticamente via Smithery:

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

Instalação Manual

Instale usando uv:

uv tool install arxiv-mcp-server

Para desenvolvimento:

# Clone and set up development environment
git clone https://github.com/blazickjp/arxiv-mcp-server.git
cd arxiv-mcp-server

# Create and activate virtual environment
uv venv
source .venv/bin/activate

# Install with test dependencies
uv pip install -e ".[test]"

🔌 Integração MCP

Adicione esta configuração ao arquivo de configuração do seu cliente MCP:

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

Para Desenvolvimento:

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

💡 Ferramentas Disponíveis

O servidor fornece quatro ferramentas principais:

1. Pesquisa de Artigos

Pesquise artigos com filtros opcionais:

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

2. Download de Artigos

Baixe um artigo pelo seu ID do arXiv:

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

3. Listar Artigos

Visualize todos os artigos baixados:

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

4. Ler Artigo

Acesse o conteúdo de um artigo baixado:

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

⚙️ Configuração

Configure por meio de variáveis de ambiente:

Variável	Finalidade	Padrão
ARXIV_STORAGE_PATH	Local de armazenamento dos artigos	~/.arxiv-mcp-server/papers

🧪 Testes

Execute a suíte de testes:

python -m pytest

📄 Licença

Publicado sob a Licença MIT. Consulte o arquivo LICENSE para obter detalhes.

---