IACR ePrint Archive

Pesquise e recupere artigos de pesquisa criptográfica do IACR Cryptology ePrint Archive.

Documentação

Servidor MCP do IACR ePrint Archive

Um servidor Model Context Protocol (MCP) que fornece acesso ao IACR Cryptology ePrint Archive, permitindo que assistentes de IA pesquisem e recuperem artigos de pesquisa criptográfica.

✨ Recursos

🔍 Pesquisa Inteligente: Pesquise artigos por título, resumo, autor ou palavras-chave (filtragem baseada em RSS)
📄 Detalhes do Artigo: Obtenha informações abrangentes sobre artigos específicos
📰 Artigos Recentes: Recupere os artigos publicados mais recentes do feed RSS
🔗 Links Diretos: Obtenha URLs de páginas web e PDFs para artigos
📋 Informações de Download: Obtenha informações de download para PDFs de artigos
🔒 Foco em Privacidade: Sem cookies, sem rastreamento, respeita as diretrizes do ePrint Archive

🚀 Início Rápido

Instalação

Opção 1: Instalação Direta

# Clone the repository
git clone https://github.com/YOUR_USERNAME/eprint-mcp-server.git
cd eprint-mcp-server

# Install dependencies and build
npm install
npm run build

Opção 2: Usando npx (Em Breve)

npx eprint-mcp-server

Configuração do Claude Desktop

Encontre o arquivo de configuração do Claude Desktop:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

Adicione a configuração do servidor:

{
  "mcpServers": {
    "eprint": {
      "command": "node",
      "args": ["/path/to/eprint-mcp-server/dist/index.js"]
    }
  }
}

Reinicie o Claude Desktop completamente (⌘+Q e depois reabra)

📖 Exemplos de Uso

Pesquisar Artigos

Find papers about "zero knowledge proofs"

Obter Artigos Recentes

Show me the 10 most recent cryptography papers

Obter Detalhes do Artigo

Tell me about paper 2025/123

Encontrar por Autor

Find papers by Goldreich from 2024

🛠️ Desenvolvimento

Pré-requisitos

Node.js 18.0.0 ou superior
npm ou yarn

Configuração

git clone https://github.com/YOUR_USERNAME/eprint-mcp-server.git
cd eprint-mcp-server
npm install

Comandos de Desenvolvimento

# Development with hot reload
npm run dev

# Build for production
npm run build

# Run tests
npm test

# Type checking
npm run type-check

Estrutura do Projeto

eprint-mcp-server/
├── src/
│   ├── index.ts          # Main MCP server
│   ├── eprintClient.ts   # ePrint Archive API client
│   └── types.ts          # TypeScript type definitions
├── dist/                 # Compiled JavaScript output
├── tests/               # Test files
├── package.json
└── README.md

🔧 Configuração

Variáveis de Ambiente

DEBUG: Defina como 1 para habilitar o registro de depuração
MAX_RESULTS: Número máximo de resultados de pesquisa (padrão: 100)

Opções do Servidor MCP

{
  "mcpServers": {
    "eprint": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {
        "DEBUG": "0",
        "MAX_RESULTS": "50"
      }
    }
  }
}

📚 Ferramentas Disponíveis

Ferramenta	Descrição	Parâmetros
`search_papers`	Pesquisar artigos	`query`, `maxResults`, `author`, `dateFrom`, `dateTo`
`get_paper`	Obter detalhes do artigo	`paperId`
`get_recent_papers`	Obter artigos recentes	`limit`
`download_paper`	Obter informações de download	`paperId`, `outputPath`
`get_paper_url`	Obter URLs do artigo	`paperId`

🔍 Limitações da Pesquisa

Atualmente, o endpoint da API de pesquisa do ePrint Archive não está disponível publicamente, então este servidor usa filtragem de feed RSS para a funcionalidade de pesquisa. Isso significa:

✅ A pesquisa funciona dentro de artigos recentes (últimos ~100 artigos do RSS)
⚠️ A pesquisa histórica é limitada
🔄 Estamos trabalhando na implementação de recursos completos de pesquisa

🤝 Contribuindo

Faça um fork do repositório
Crie um branch de recurso (git checkout -b feature/amazing-feature)
Faça commit das suas alterações (git commit -m 'Add amazing feature')
Envie para o branch (git push origin feature/amazing-feature)
Abra um Pull Request

📄 Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

🙏 Agradecimentos

IACR Cryptology ePrint Archive por fornecer acesso aberto à pesquisa criptográfica
Model Context Protocol pelo framework MCP
A comunidade de pesquisa criptográfica

📞 Suporte

🐛 Problemas: GitHub Issues
💬 Discussões: GitHub Discussions
📧 E-mail: your.email@example.com

🔄 Histórico de Versões

v1.0.0 (2025-06-25)

✨ Lançamento inicial
🔍 Funcionalidade de pesquisa baseada em RSS
📄 Recuperação de detalhes de artigos
📰 Listagem de artigos recentes
🔗 Geração de URLs diretas

Feito com ❤️ para a comunidade de pesquisa criptográfica