arXiv Research Assistant

🧠 arXiv Research Assistant MCP Server

Este projeto é um servidor MCP (Model Context Protocol) construído para interagir com a vasta base de dados de artigos do arXiv.org.

Ele permite que clientes como Claude AI pesquisem, explorem e comparem artigos do arXiv de forma eficiente — tudo através de um servidor local personalizado. Ele é construído com Python e o framework FastMCP, e usa uv para gerenciamento leve de pacotes.

✨ Recursos

• 🔍 Busca de Artigos por Palavras-chave
  Pesquise artigos do arXiv por palavras-chave, com opções de ordenação por relevância ou mais recentes.

• 📚 Artigos Recentes por Categoria
  Especifique um código de categoria do arXiv (ex.: cs.AI, math.AP) para obter os artigos mais recentes dessa área.

• 📄 Consulta de Detalhes do Artigo
  Obtenha metadados detalhados usando o ID do artigo no arXiv: título, autores, resumo, categorias, DOI, link do PDF e mais.

• 🧑‍🔬 Busca de Artigos por Autor
  Recupere uma lista de artigos publicados por um autor específico.

• 📊 Análise de Tendências (Experimental)
  Obtenha uma visão geral de palavras-chave ou tópicos em alta com base em artigos recentes de uma categoria (atualmente usa dados simulados).

• 📝 Gerador de Prompt de Resumo
  Gere dinamicamente prompts que ajudam LLMs a resumir um artigo selecionado de forma mais eficaz.

• 🆚 Gerador de Prompt de Comparação
  Forneça dois IDs de artigos para gerar um prompt estruturado para comparar seu conteúdo.

---

🛠️ Stack de Tecnologias

• Python 3.11+
• FastMCP
• uv (para gerenciamento de dependências e ambiente)
• requests (para comunicação com API)
• xml.etree.ElementTree (para análise de respostas XML)

---

🚀 Começando

Instalação via Smithery

Para instalar o arXiv Research Assistant MCP Server para Claude Desktop automaticamente via Smithery:

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

Instalação a partir do PyPI

uv pip install arxiv-paper-mcp

🔧 Clone o repositório (para desenvolvimento)

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

🔧 Instale as Dependências (para desenvolvimento)

Use uv para instalar todas as dependências em modo editável:

uv pip install -e .

⚙️ Como Executar

▶️ Execute o servidor (localmente)

arxiv-paper-mcp

🔌 Uso com Claude

Para usar este servidor MCP com Claude, adicione a seguinte configuração JSON às configurações do MCP do Claude:

{
  "mcpServers": {
    "arXivPaper": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "arxiv-paper-mcp"
      ]
    }
  }
}

Estrutura do Projeto

arxiv-mcp-server/
├── arxiv_mcp/              # Main package
│   ├── __init__.py
│   ├── app.py              # FastMCP app setup
│   ├── server.py           # Server entry point
│   ├── utils.py            # arXiv API communication logic
│   ├── resources/          # MCP resources (categories, authors, etc.)
│   ├── tools/              # MCP tools (search, detail lookup, trends)
│   └── prompts/            # Prompt templates (summarize, compare)
├── pyproject.toml          # Project config & dependencies
└── README.md               # This file