Academic Paper Search

Academic Paper Search MCP Server

Un servidor de Model Context Protocol (MCP) que permite buscar y recuperar información de artículos académicos de múltiples fuentes.

El servidor proporciona a los LLM:

• Funcionalidad de búsqueda de artículos académicos en tiempo real
• Acceso a metadatos y resúmenes de artículos
• Capacidad de recuperar el texto completo cuando esté disponible
• Respuestas de datos estructurados siguiendo la especificación MCP

Aunque está diseñado principalmente para la integración con el cliente Claude Desktop de Anthropic, la especificación MCP permite una posible compatibilidad con otros modelos de IA y clientes que admitan capacidades de llamada a herramientas/funciones (por ejemplo, la API de OpenAI).

Nota: Este software está en desarrollo activo. Las características y funcionalidades están sujetas a cambios.

Características

Este servidor expone las siguientes herramientas:

• search_papers: Buscar artículos académicos en múltiples fuentes

  • Parámetros:
    • query (str): Texto de la consulta de búsqueda
    • limit (int, opcional): Número máximo de resultados a devolver (por defecto: 10)
  • Devuelve: Cadena formateada con los detalles del artículo

• fetch_paper_details: Recuperar información detallada de un artículo específico

  • Parámetros:
    • paper_id (str): Identificador del artículo (DOI o ID de Semantic Scholar)
    • source (str, opcional): Fuente de datos ("crossref" o "semantic_scholar", por defecto: "crossref")
  • Devuelve: Cadena formateada con metadatos completos del artículo, incluyendo:
    • Título, autores, año, DOI
    • Lugar de publicación, estado de acceso abierto, URL del PDF (solo Semantic Scholar)
    • Resumen y resumen TL;DR (cuando estén disponibles)

• search_by_topic: Buscar artículos por tema con filtro opcional de rango de fechas

  • Parámetros:
    • topic (str): Texto de la consulta de búsqueda (limitado a 300 caracteres)
    • year_start (int, opcional): Año de inicio para el rango de fechas
    • year_end (int, opcional): Año de fin para el rango de fechas
    • limit (int, opcional): Número máximo de resultados a devolver (por defecto: 10)
  • Devuelve: Cadena formateada con los resultados de búsqueda, incluyendo:
    • Títulos, autores y años de los artículos
    • Resúmenes y resúmenes TL;DR cuando estén disponibles
    • Información del lugar de publicación y acceso abierto

Configuración

Instalación mediante Smithery

Para instalar Academic Paper Search Server para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @afrise/academic-search-mcp-server --client claude

nota este método está en gran medida sin probar, ya que su servidor parece estar teniendo problemas. Puedes seguir las instrucciones independientes hasta que Smithery se arregle.

Instalación mediante uv (instalación manual):

1. Instala las dependencias:

uv add "mcp[cli]" httpx

2. Configura las claves de API necesarias en tu entorno o en el archivo .env:

#  These are not actually implemented
SEMANTIC_SCHOLAR_API_KEY=your_key_here 
CROSSREF_API_KEY=your_key_here  # Optional but recommended

3. Ejecuta el servidor:

uv run server.py

Uso con Claude Desktop

1. Añade el servidor a tu configuración de Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "academic-search": {
      "command": "uv",
      "args": ["run ", "/path/to/server/server.py"],
      "env": {
        "SEMANTIC_SCHOLAR_API_KEY": "your_key_here",
        "CROSSREF_API_KEY": "your_key_here"
      }
    }
  }
}

2. Reinicia Claude Desktop

Desarrollo

Este servidor está construido con:

• Python MCP SDK
• FastMCP para una implementación simplificada del servidor
• httpx para solicitudes de API

Fuentes de API

• Semantic Scholar API
• Crossref API

Licencia

Este proyecto está licenciado bajo la GNU Affero General Public License v3.0 (AGPL-3.0). Esta licencia garantiza que:

• Puedes usar, modificar y distribuir este software libremente
• Cualquier modificación debe ser de código abierto bajo la misma licencia
• Cualquier persona que proporcione servicios de red utilizando este software debe poner el código fuente a disposición
• Se permite el uso comercial, pero el software y cualquier derivado deben permanecer libres y de código abierto

Consulta el archivo LICENSE para ver el texto completo de la licencia.

Contribuciones

¡Las contribuciones son bienvenidas! Así es como puedes ayudar:

1. Haz un fork del repositorio
2. Crea una rama de características (git checkout -b feature/amazing-feature)
3. Haz commit de tus cambios (git commit -m 'Add amazing feature')
4. Haz push a la rama (git push origin feature/amazing-feature)
5. Abre un Pull Request

Ten en cuenta:

• Sigue el estilo de código y las convenciones existentes
• Añade pruebas para cualquier funcionalidad nueva
• Actualiza la documentación según sea necesario
• Asegúrate de que tus cambios respeten los términos de la licencia AGPL-3.0

Al contribuir a este proyecto, aceptas que tus contribuciones serán licenciadas bajo la licencia AGPL-3.0.