medRxiv
Pesquise e recupere artigos do medRxiv, o servidor de preprints para ciências da saúde.
Documentação
Servidor MCP medRxiv
🔍 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 pesquisanum_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 geraltitle(str, opcional): Pesquisar no títuloauthor1(str, opcional): Primeiro autorauthor2(str, opcional): Segundo autorabstract_title(str, opcional): Pesquisar no resumo e no títulotext_abstract_title(str, opcional): Pesquisar no texto completo, resumo e títulosection(str, opcional): Seção do medRxivstart_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 FastMCPmedrxiv_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.