Paper Search Gateway

FastMCP gateway that exposes paper-search-mcp as an HTTP MCP server.

Soporta búsqueda y descarga de papers académicos desde arXiv, PubMed, bioRxiv, medRxiv y Google Scholar.

Tools disponibles

Tool	Descripción
papers_search_arxiv	Busca en arXiv
papers_search_pubmed	Busca en PubMed
papers_search_biorxiv	Busca en bioRxiv
papers_search_medrxiv	Busca en medRxiv
papers_search_google_scholar	Busca en Google Scholar
papers_download_arxiv	Descarga PDF de arXiv
papers_download_biorxiv	Descarga PDF de bioRxiv
papers_download_medrxiv	Descarga PDF de medRxiv
papers_read_arxiv_paper	Lee texto de un paper de arXiv

Variables de entorno

Variable	Default	Descripción
TRANSPORT	http	Transporte MCP: http, sse, stdio
HOST	0.0.0.0	Host donde escucha el servidor
PORT	8000	Puerto donde escucha el servidor
SEMANTIC_SCHOLAR_API_KEY	(vacío)	API key opcional de Semantic Scholar

Copia .env.example a .env y edita los valores.

Desarrollo local

uv sync
uv run python main.py

El servidor queda disponible en http://localhost:8000/mcp.

Docker

docker build -t paper-search-gateway .
docker run -p 8000:8000 --env-file .env paper-search-gateway

Despliegue en Dokploy

1. Conecta el repositorio en Dokploy → New Application → GitHub
2. Selecciona Dockerfile como método de build
3. Añade las variables de entorno en Environment Variables:
   • TRANSPORT=http
   • PORT=8000
   • SEMANTIC_SCHOLAR_API_KEY= (opcional)
4. Expón el puerto 8000
5. El endpoint MCP quedará en: https://tu-dominio.com/mcp

Conectar desde un cliente MCP

{
  "mcpServers": {
    "papers": {
      "url": "https://tu-dominio.com/mcp",
      "transport": "http"
    }
  }
}