Servidor MCP de Global Papers

👁 License: MIT
👁 Python 3.11+
👁 FastMCP
👁 Fly.io

Servidor MCP de búsqueda integrada de artículos académicos internacionales - Integración de APIs de OpenAlex, Semantic Scholar, CrossRef y arXiv

⚡ Inicio rápido (5 minutos)

🎯 2 métodos de despliegue

Método 1: Railway (El más fácil - ¡Recomendado!)

¡Despliegue automático solo con hacer push a GitHub!

1. Hacer push a GitHub

   cd global-papers-mcp
   git init && git add . && git commit -m "Initial commit"
   git remote add origin https://github.com/YOUR_USERNAME/global-papers-mcp.git
   git push -u origin main

2. Conectar a Railway

   • Visita https://railway.app

   • Sign in with GitHub

   • New Project → Deploy from GitHub repo

   • Selecciona global-papers-mcp → Deploy Now

3. Verificar dominio

   • Settings → Networking → Generate Domain

   • Copia la URL: https://xxx.up.railway.app/mcp

4. Conectar a Claude.ai

   • Settings → Connectors → Add Connector

   • Introduce la URL → Guardar

¡Listo! 🎉

Guía detallada: RAILWAY_DEPLOY.md

Método 2: Fly.io (Usuarios avanzados)

Script de despliegue automático:

# Mac/Linux
./deploy.sh

# Windows
deploy.bat

Guía detallada: ONE_CLICK_DEPLOY.md

Related MCP server: arXiv Research Assistant MCP Server

📋 Índice

• Resumen rápido

• Descripción general

• Funciones principales

• Instalación y ejecución

  • Ejecución local

  • Despliegue en Fly.io

• Registro del conector MCP en Claude

  • Método 1: Web/Móvil de Claude.ai (Recomendado)

  • Método 2: Aplicación Claude Desktop

  • Verificación de conexión y pruebas

  • Solución de problemas

• Configuración de API Key

• Ejemplos de uso

• Stack tecnológico

• Límites de tasa (Rate Limits)

• Proyectos de referencia

• Licencia

• Contribución

• Contacto

🎯 Resumen rápido

Servidor MCP para realizar búsquedas integradas de más de 500 millones de artículos académicos en Claude.ai

• 🔍 Integración de 4 APIs - OpenAlex, Semantic Scholar, CrossRef, arXiv

• 🛠 13 herramientas - Búsqueda, detalles, seguimiento de citas, información de autores/instituciones

• 🚀 Despliegue en 5 minutos - Respuesta rápida con la región de Tokio de Fly.io

• 📚 Documentación completa - 11 guías disponibles

• ✅ La mayoría de las API Keys no son necesarias - OpenAlex, CrossRef y arXiv están listos para usar

Descripción general

Es un servidor MCP (Model Context Protocol) que permite buscar y analizar artículos académicos internacionales en Claude.ai. Integra 4 APIs académicas principales para ofrecer funciones de búsqueda exhaustivas.

APIs compatibles

1. OpenAlex - Más de 250 millones de artículos en todas las disciplinas

2. Semantic Scholar - Más de 200 millones de artículos especializados en IA/ML

3. CrossRef - Más de 150 millones de metadatos basados en DOI

4. arXiv - Más de 2,4 millones de preprints de física/matemáticas/CS

Funciones principales

Herramientas de OpenAlex (4)

• openalex_search_papers - Buscar artículos

• openalex_get_paper_detail - Detalles del artículo

• openalex_get_author - Consultar información del autor

• openalex_search_institutions - Buscar instituciones

Herramientas de Semantic Scholar (4)

• semantic_search_papers - Buscar artículos

• semantic_get_paper_detail - Detalles del artículo

• semantic_get_citations - Consultar artículos citados

• semantic_get_references - Consultar referencias bibliográficas

Herramientas de CrossRef (3)

• crossref_search_works - Buscar artículos

• crossref_get_work_by_doi - Consultar artículo por DOI

• crossref_search_journals - Buscar revistas

Herramientas de arXiv (2)

• arxiv_search_papers - Buscar artículos

• arxiv_get_paper_detail - Detalles del artículo

Instalación y ejecución

Ejecución local

# 1. 저장소 클론
git clone https://github.com/YOUR_USERNAME/global-papers-mcp.git
cd global-papers-mcp

# 2. 의존성 설치
pip install -r requirements.txt

# 3. 환경 변수 설정 (선택)
cp .env.example .env
# .env 파일에서 SEMANTIC_SCHOLAR_API_KEY 설정 (선택사항)

# 4. 로컬 테스트 실행
python server.py

Despliegue en Fly.io

# 1. Fly.io CLI 설치
curl -L https://fly.io/install.sh | sh

# 2. Fly.io 로그인
flyctl auth login

# 3. 앱 생성 (도쿄 리전 사용으로 latency 최소화)
flyctl launch --no-deploy

# 4. 리전을 Tokyo(nrt)로 변경
flyctl regions set nrt

# 5. 배포
flyctl deploy

# 6. API 키 설정 (Semantic Scholar 사용 시)
flyctl secrets set SEMANTIC_SCHOLAR_API_KEY=your_api_key_here

# 7. MCP URL 확인
flyctl info
# URL 예시: https://global-papers-mcp.fly.dev/mcp

Registro del conector MCP en Claude

🌐 Método 1: Claude.ai Web/Móvil (Recomendado)

¡Es el método más sencillo y rápido!

Paso 1: Desplegar el servidor MCP y obtener la URL

Primero, completa el despliegue en Fly.io (consulta Despliegue en Fly.io arriba)

# 배포 후 MCP URL 확인
flyctl info

Ejemplo de salida:

Hostname = global-papers-mcp.fly.dev

URL del MCP: https://global-papers-mcp.fly.dev/mcp (¡Es obligatorio incluir /mcp al final!)

Paso 2: Acceder a Claude.ai

Entra en https://claude.ai desde tu navegador web (o abre la aplicación móvil)

Paso 3: Abrir el menú de configuración

Web (Escritorio):

• Haz clic en el icono de perfil (o tu nombre) en la esquina inferior izquierda

• Selecciona Settings (Configuración)

Móvil (iOS/Android):

• Toca el botón de menú (≡) en la esquina superior derecha

• Selecciona Settings (Configuración)

Paso 4: Ir al menú de conectores

• Haz clic en el menú Connectors o Integrations

• O selecciona Features → Model Context Protocol

Paso 5: Añadir nuevo conector

Haz clic en el botón Add Connector o + Add

Paso 6: Introducir la información del MCP

Introduce la siguiente información con precisión:

⚠️ Importante: ¡Asegúrate de incluir /mcp al final de la URL!

Ejemplo:

• ✅ URL correcta: https://global-papers-mcp.fly.dev/mcp

• ❌ URL incorrecta: https://global-papers-mcp.fly.dev

Paso 7: Guardar y conectar

• Haz clic en el botón Connect o Save

• Se ejecutará una prueba de conexión automática

• Verifica que el estado sea "Connected" o "Active"

Paso 8: Verificación de conexión y pruebas

Verificar en la lista de Connectors:

• Global Papers MCP aparece en la lista

• Estado: 🟢 Connected

Prueba de uso real:

Inicia una nueva conversación e introduce el siguiente comando:

"OpenAlex에서 machine learning 관련 논문 5개 검색해줘"

¡Si Claude devuelve resultados de búsqueda de artículos, es un éxito! 🎉

💻 Método 2: Aplicación Claude Desktop

Si utilizas la aplicación Claude Desktop en tu PC local

Opción A: Usar la URL de despliegue de Fly.io (Recomendado)

1. Localizar el archivo de configuración

   Rutas según el sistema operativo:

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • Linux: ~/.config/claude/claude_desktop_config.json

2. Abrir el archivo de configuración

   Mac/Linux:

   # 파일이 없으면 생성
   mkdir -p ~/Library/Application\ Support/Claude/
   nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

   Windows:

   notepad %APPDATA%\Claude\claude_desktop_config.json

3. Añadir el servidor MCP

   Introduce el siguiente contenido o añádelo al archivo existente:

   {
    "mcpServers": {
    "global-papers": {
    "url": "https://global-papers-mcp.fly.dev/mcp"
    }
    }
   }

   Si utilizas varios servidores MCP:

   {
    "mcpServers": {
    "global-papers": {
    "url": "https://global-papers-mcp.fly.dev/mcp"
    },
    "kci-papers": {
    "url": "https://kci-mcp-korea.fly.dev/mcp"
    }
    }
   }

4. Guardar archivo y reiniciar Claude Desktop

   • Guarda el archivo de configuración (Ctrl+S o Cmd+S)

   • Cierra completamente la aplicación Claude Desktop

   • Vuelve a ejecutar Claude Desktop

5. Verificar conexión

   Tras iniciar una nueva conversación en Claude Desktop:

   "사용 가능한 도구를 보여줘"

   ¡Si aparecen las herramientas de Global Papers MCP, es un éxito!

Opción B: Ejecutar servidor local

Si solo ejecutas localmente sin Fly.io

1. Preparar la ejecución del servidor local

   cd /path/to/global-papers-mcp
   pip install -r requirements.txt

2. Modificar el archivo de configuración

   claude_desktop_config.json:

   {
    "mcpServers": {
    "global-papers": {
    "command": "python",
    "args": ["/absolute/path/to/global-papers-mcp/server.py"]
    }
    }
   }

   ⚠️ Atención:

   • La ruta debe ser una ruta absoluta

   • Windows: C:\\Users\\YourName\\global-papers-mcp\\server.py

   • Mac/Linux: /Users/YourName/global-papers-mcp/server.py

3. Reiniciar Claude Desktop

   Reinicia la aplicación después de guardar el archivo de configuración

4. Ejecución automática del servidor

   El servidor local se iniciará automáticamente cuando se ejecute Claude Desktop.

🔍 Verificación de conexión y pruebas

Verificar estado de conexión

Claude.ai (Web/Móvil):

1. Settings → Connectors

2. Verificar estado de Global Papers

   • 🟢 Connected = Normal

   • 🔴 Disconnected = Error

Claude Desktop:

1. Iniciar nueva conversación

2. Introducir el siguiente comando:

   "연결된 MCP 서버를 보여줘"

Prueba de funciones

Búsqueda básica:

"OpenAlex에서 transformer architecture 관련 논문 5개 검색해줘"

Consulta por DOI:

"CrossRef에서 이 DOI의 논문을 조회해줘: 10.1038/s41586-021-03819-2"

Búsqueda en arXiv:

"arXiv에서 cs.AI 카테고리의 최신 논문 10개 보여줘"

Seguimiento de relaciones de citas:

"Semantic Scholar에서 'Attention is All You Need' 논문을 검색하고, 이 논문을 인용한 주요 논문들을 찾아줘"

⚠️ Solución de problemas

Error "Connection failed"

Causa 1: Error de URL

• Falta el endpoint /mcp

• Solución: Añadir /mcp al final de la URL

Causa 2: Servidor no ejecutándose

# Fly.io 서버 상태 확인
flyctl status

# 서버가 중지되어 있으면
flyctl apps restart

Causa 3: Bloqueo de firewall

• Es posible que Fly.io esté bloqueado en redes corporativas/escolares

• Solución: Intentar con otra red o consultar al departamento de TI

Las herramientas no aparecen

Claude.ai:

1. Recargar el navegador

2. Cerrar sesión y volver a iniciar

3. Probar con otro navegador

Claude Desktop:

1. Verificar la ruta del archivo de configuración

2. Verificar errores de sintaxis JSON (validar en JSONLint)

3. Cerrar la aplicación completamente y reiniciar

Velocidad de respuesta lenta

Causa: Problema de región

# 현재 리전 확인
flyctl regions list

# Tokyo(nrt) 리전으로 변경
flyctl regions set nrt
flyctl deploy

📚 Ayuda adicional

• Guía detallada: DEPLOYMENT.md

• Solución de problemas: TROUBLESHOOTING.md

• Ejemplos de uso: EXAMPLES.md

• FAQ: FAQ.md

---## Configuración de API Key

La mayoría de las APIs se pueden usar sin clave, pero Semantic Scholar suaviza los límites de tasa (rate limits) si se utiliza una API Key.

Obtener API Key de Semantic Scholar

1. Visita https://www.semanticscholar.org/product/api

2. Haz clic en "Get API Key" para obtener una clave gratuita

3. Configúrala en el archivo .env o como variable de entorno

Ejemplos de uso

Úsalo en Claude.ai de la siguiente manera:

"transformer 아키텍처 관련 최신 논문을 OpenAlex에서 검색해줘"

"이 DOI의 논문을 CrossRef에서 조회해줘: 10.1038/nature12345"

"arXiv에서 quantum computing 관련 최신 프리프린트 찾아줘"

"Semantic Scholar에서 이 논문을 인용한 논문들을 찾아줘"

Stack tecnológico

• FastMCP - Framework de servidor MCP

• httpx - Cliente HTTP asíncrono

• Python 3.9+

• Fly.io - Plataforma de despliegue (región Tokio)

Límites de tasa (Rate Limits)

• OpenAlex: 100,000 solicitudes/día (no requiere API Key)

• Semantic Scholar: 100 solicitudes/5 minutos sin API Key, se suaviza con API Key

• CrossRef: respuesta más rápida usando el "polite pool"

• arXiv: se recomienda 1 solicitud/3 segundos

Proyectos de referencia

• kci-mcp-korea - Servidor MCP del Índice de Citas de Revistas Coreanas (KCI)

Licencia

MIT License

Contribución

¡Las incidencias (issues) y PRs son bienvenidos!

Contacto

• GitHub Issues: https://github.com/YOUR_USERNAME/global-papers-mcp/issues

Resources

• GitHub Repository
Need Help?Related Servers