medRxiv

Pesquise e recupere artigos do medRxiv, o servidor de preprints para ciências da saúde.

Documentação

Servidor MCP medRxiv

smithery badge

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

O medRxiv MCP Server fornece uma ponte entre assistentes de IA e o repositório de preprints do medRxiv através do Model Context Protocol (MCP). Ele permite que modelos de IA pesquisem preprints de ciências da saúde e acessem seu conteúdo de forma programática.

🤝 Contribua • 📝 Reporte um Bug

✨ Recursos Principais

  • 🔎 Pesquisa de Artigos: Consulte artigos do medRxiv com strings de pesquisa personalizadas ou parâmetros de pesquisa avançados ✅
  • 🚀 Recuperação Eficiente: Acesso rápido aos metadados dos artigos ✅
  • 📊 Acesso a Metadados: Recupere metadados detalhados de artigos específicos usando DOI ✅
  • 📊 Suporte à Pesquisa: Facilite a pesquisa e análise em ciências da saúde ✅
  • 📄 Acesso a Artigos: Baixe e leia o conteúdo dos artigos 📝
  • 📋 Listagem de Artigos: Veja todos os artigos baixados 📝
  • 🗃️ Armazenamento Local: Os artigos são salvos localmente para acesso mais rápido 📝
  • 📝 Prompts de Pesquisa: Um conjunto de prompts especializados para análise de artigos 📝

🚀 Início Rápido

Instalação via Smithery

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

claude

npx -y @smithery/cli@latest install @JackKuo666/medrxiv-mcp-server --client claude --config "{}"

Cursor

Cole o seguinte em Configurações → Configurações do Cursor → MCP → Adicionar novo servidor:

  • Mac/Linux
npx -y @smithery/cli@latest run @JackKuo666/medrxiv-mcp-server --client cursor --config "{}" 

Windsurf

npx -y @smithery/cli@latest install @JackKuo666/medrxiv-mcp-server --client windsurf --config "{}"

CLine

npx -y @smithery/cli@latest install @JackKuo666/medrxiv-mcp-server --client cline --config "{}"

Instalação Manual

Instale usando uv:

uv tool install medRxiv-mcp-server

Para desenvolvimento:

# Clone and set up development environment
git clone https://github.com/JackKuo666/medRxiv-MCP-Server.git
cd medRxiv-MCP-Server

# Create and activate virtual environment
uv venv
source .venv/bin/activate
uv pip install -r requirements.txt

📊 Uso

Inicie o servidor MCP:

python medrxiv_server.py

Depois que o servidor estiver em execução, você pode usar as ferramentas MCP fornecidas no seu assistente de IA ou aplicativo. Aqui estão alguns exemplos de como usar as ferramentas:

Exemplo 1: Pesquisar artigos usando palavras-chave

result = await mcp.use_tool("search_medrxiv_key_words", {
    "key_words": "COVID-19 vaccine efficacy",
    "num_results": 5
})
print(result)

Exemplo 2: Realizar uma pesquisa avançada

result = await mcp.use_tool("search_medrxiv_advanced", {
    "term": "COVID-19",
    "author1": "MacLachlan",
    "start_date": "2020-01-01",
    "end_date": "2023-12-31",
    "num_results": 3
})
print(result)

Exemplo 3: Obter metadados de um artigo específico

result = await mcp.use_tool("get_medrxiv_metadata", {
    "doi": "10.1101/2025.03.09.25323517"
})
print(result)

Esses exemplos demonstram como usar as três principais ferramentas fornecidas pelo medRxiv MCP Server. Ajuste os parâmetros conforme necessário para o seu caso de uso específico.

🛠 Ferramentas MCP

O medRxiv MCP Server fornece as seguintes ferramentas:

search_medrxiv_key_words

Pesquise artigos no medRxiv usando palavras-chave.

Parâmetros:

  • key_words (str): String de consulta de pesquisa
  • num_results (int, opcional): Número de resultados a retornar (padrão: 10)

Retorna: Lista de dicionários contendo informações do artigo

search_medrxiv_advanced

Realize uma pesquisa avançada de artigos no medRxiv.

Parâmetros:

  • term (str, opcional): Termo de pesquisa geral
  • title (str, opcional): Pesquisar no título
  • author1 (str, opcional): Primeiro autor
  • author2 (str, opcional): Segundo autor
  • abstract_title (str, opcional): Pesquisar no resumo e no título
  • text_abstract_title (str, opcional): Pesquisar no texto completo, resumo e título
  • section (str, opcional): Seção do medRxiv
  • start_date (str, opcional): Data de início para o intervalo de pesquisa (formato: YYYY-MM-DD)
  • end_date (str, opcional): Data de término para o intervalo de pesquisa (formato: YYYY-MM-DD)
  • num_results (int, opcional): Número de resultados a retornar (padrão: 10)

Retorna: Lista de dicionários contendo informações do artigo

get_medrxiv_metadata

Obtenha metadados de um artigo do medRxiv usando seu DOI.

Parâmetros:

  • doi (str): DOI do artigo

Retorna: Dicionário contendo metadados do artigo

Uso com Claude Desktop

Adicione esta configuração ao seu claude_desktop_config.json:

(Mac OS)

{
  "mcpServers": {
    "medrxiv": {
      "command": "python",
      "args": ["-m", "medrxiv-mcp-server"]
      }
  }
}

(Versão Windows):

{
  "mcpServers": {
    "medrxiv": {
      "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
      "args": [
        "-m",
        "medrxiv-mcp-server"
      ]
    }
  }
}

Usando com Cline

{
  "mcpServers": {
    "medrxiv": {
      "command": "bash",
      "args": [
        "-c",
        "source /home/YOUR/PATH/mcp-server-medRxiv/.venv/bin/activate && python /home/YOUR/PATH/mcp-server-medRxiv/medrxiv_server.py"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

Após reiniciar o Claude Desktop, os seguintes recursos estarão disponíveis:

Pesquisando Artigos

Você pode pedir ao Claude para pesquisar artigos usando consultas como:

Can you search medRxiv for recent papers about genomics?

A pesquisa retornará informações básicas sobre os artigos correspondentes, incluindo:

• Título do artigo

• Autores

• DOI

Obtendo Detalhes do Artigo

Depois de ter um DOI, você pode pedir mais detalhes:

Can you show me the details for paper 10.1101/003541?

Isso retornará:

• Título completo do artigo

• Autores

• Data de publicação

• Resumo do artigo

• Links para formatos disponíveis (PDF/HTML)

📝 A FAZER

download_paper

Baixe um artigo e salve-o localmente.

read_paper

Leia o conteúdo de um artigo baixado.

list_papers

Liste todos os artigos baixados.

📝 Prompts de Pesquisa

O servidor oferece prompts especializados para ajudar a analisar artigos acadêmicos:

Prompt de Análise de Artigos

Um fluxo de trabalho abrangente para analisar artigos acadêmicos que requer apenas um ID de artigo:

result = await call_prompt("deep-paper-analysis", {
    "paper_id": "2401.12345"
})

Este prompt inclui:

  • Instruções detalhadas para usar as ferramentas disponíveis (list_papers, download_paper, read_paper, search_papers)
  • Um fluxo de trabalho sistemático para análise de artigos
  • Estrutura de análise abrangente cobrindo:
    • Resumo executivo
    • Contexto da pesquisa
    • Análise de metodologia
    • Avaliação de resultados
    • Implicações práticas e teóricas
    • Direções futuras de pesquisa
    • Impactos mais amplos

📁 Estrutura do Projeto

  • medrxiv_server.py: A implementação principal do servidor MCP usando FastMCP
  • medrxiv_web_search.py: Contém a lógica de raspagem de dados para pesquisar no medRxiv

🔧 Dependências

  • Python 3.10+
  • FastMCP
  • asyncio
  • logging
  • requests (para raspagem de dados, usado em medrxiv_web_search.py)
  • beautifulsoup4 (para raspagem de dados, usado em medrxiv_web_search.py)

Você pode instalar as dependências necessárias usando:

pip install FastMCP requests beautifulsoup4

🤝 Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

📄 Licença

Este projeto é licenciado sob a Licença MIT.

🙏 Agradecimentos

Este projeto é inspirado e construído sobre o trabalho realizado no projeto arxiv-mcp-server.

⚠️ Aviso Legal

Esta ferramenta é apenas para fins de pesquisa. Respeite os termos de serviço do medRxiv e use esta ferramenta com responsabilidade.