paper-search-mcp-gateway

Paper Search MCP 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)_

1. Expón el puerto 8000
2. 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"
    }
  }
}