Space Frontiers

Interactúa con la API de Space Frontiers, permitiendo que los modelos de lenguaje interactúen con sus fuentes de datos.

GitHub
11
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Machine Library

Servidor MCP oficial para Machine Library, el producto de búsqueda e IA de Space Frontiers Company.

  • Endpoint: https://mcp.machinelibrary.ai (canónico)
  • Nombre del servidor: machinelibrary; las herramientas tienen el prefijo machinelibrary_
  • Guía de instalación para agentes: https://machinelibrary.ai/install.md

Una capa de recuperación para agentes de IA sobre artículos revisados por pares, libros, patentes, normas, Wikipedia, Reddit, Telegram, Discord y YouTube. Devuelve texto completo acotado y URIs de fuentes canónicas para citación.

Alojado en https://mcp.machinelibrary.ai/ (transporte HTTP Streamable, OAuth 2.1 con PKCE o clave API Bearer).

Prueba un ejemplo práctico: Encuentra investigación, inspecciona pasajes de respaldo y conserva citas. Incluye llamadas de herramientas exactas y observaciones de una ejecución en vivo, además de una pequeña lista de verificación de evaluación para equipos de investigación.

Machine Library MCP

Herramientas

Las cuatro herramientas principales de recuperación a continuación son de solo lectura, idempotentes y tienen el prefijo machinelibrary_ para evitar colisiones en configuraciones de agentes con múltiples servidores. Este repositorio las implementa. El servidor alojado también expone machinelibrary_research (respuestas de investigación citadas), machinelibrary_search_feedback, machinelibrary_comment_on_document y machinelibrary_top_up_balance (compra de créditos prepagados; no es de solo lectura); consulta la guía de herramientas o su tools/list.

HerramientaCuándo usarla
machinelibrary_search_documentsArtículos, libros, patentes, normas, Wikipedia, transcripciones de YouTube. Úsala para citas y arte previo.
machinelibrary_search_socialReddit, canales de Telegram, Discord. Úsala para noticias y discusión comunitaria.
machinelibrary_fetch_documentTexto completo acotado + hasta 50 referencias para una URI canónica. El valor predeterminado es 40K caracteres; admite hasta 100K.
machinelibrary_search_in_documentHasta cinco pasajes coincidentes dentro de un documento. Úsala para documentos de más de ~20K tokens.

La búsqueda tiene como valor predeterminado 10 resultados compactos con clasificación híbrida y está limitada a 30. Cada resultado incluye un source_uri canónico, un fragmento (hasta 900 caracteres), una vista previa del resumen (hasta 800 caracteres), puntuación, autores, fecha, tipo y tamaño estimado del texto completo. Los enlaces de retroceso de citas son opcionales en machinelibrary_fetch_document porque añaden otra búsqueda facturada.

Instalación

El servidor alojado tiene su propia página de instalación /mcp con enlaces de un clic para Cursor, VS Code y Smithery.

Claude Code (recomendado)

claude mcp add --transport http --scope user machinelibrary https://mcp.machinelibrary.ai

En el primer uso, se abre un navegador para el inicio de sesión OAuth — no es necesario pegar una clave API.

Cursor / VS Code / Cline / Windsurf (HTTP)

{
  "mcpServers": {
    "machinelibrary": {
      "type": "http",
      "url": "https://mcp.machinelibrary.ai",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Obtén una clave API en https://machinelibrary.ai/keys.

Autoalojado (stdio)

git clone https://github.com/SpaceFrontiers/mcp.git
cd mcp
uv sync
SEARCH_API_ENDPOINT=https://api.machinelibrary.ai \
SPACE_FRONTIERS_API_KEY=sf_live_xxx uv run fastmcp run mcp_server.py

La variable de entorno se usa como credencial de la API ascendente en modo stdio. El comando selecciona la API pública de Machine Library con SEARCH_API_ENDPOINT. El valor predeterminado interno sigue siendo http://search-api para implementaciones existentes. Para implementaciones HTTP, establece SEARCH_API_ENDPOINT en tu API de búsqueda interna de confianza y USERS_API_ENDPOINT en tu API de usuarios interna; el middleware de autenticación reenvía los encabezados de identidad verificados a ese servicio interno. OAuth usa el servidor de autorización https://api.machinelibrary.ai y el inicio de sesión en navegador en https://machinelibrary.ai.

Precios

  • Búsqueda: $0.01 base + $0.001 por resultado devuelto (el valor predeterminado de MCP de 10 resultados cuesta $0.02).
  • Obtención de documento completo: $0.05.
  • Búsqueda de pasajes dentro de un documento: $0.015.
  • referenced_by_limit > 0 en una obtención añade una búsqueda facturada por separado.

Añade créditos en https://machinelibrary.ai/payments.

Estructura del repositorio

  • mcp_server.py — Punto de entrada Starlette + FastMCP, endpoints OAuth well-known.
  • tools.py — Cuatro herramientas con esquemas de salida Pydantic.
  • prompts.py — Prompt de deep_research_agent.
  • resources.py — Plantilla de URI de spacefrontiers://document/{uri_b64}.
  • auth.py — Validación de token Bearer, lista de permitidos de Origin, verificación de MCP-Protocol-Version.
  • client.py — Cliente HTTP asíncrono para la API de búsqueda v2.
  • server.json — Entrada del Registro MCP oficial.
  • smithery.yaml — Configuración de implementación de Smithery.
  • registry.json — Metadatos del registro interno.
  • tests/ — Pruebas unitarias de pytest.

Cumplimiento de especificaciones

  • Transporte: HTTP Streamable, sin estado.
  • Autenticación: OAuth 2.1 con Registro Dinámico de Clientes RFC 7591; también se aceptan claves API de larga duración.
  • Anotaciones: cada herramienta declara readOnlyHint, idempotentHint, openWorldHint, destructiveHint:false.
  • Esquemas de salida: el outputSchema de cada herramienta se genera automáticamente a partir de un modelo de retorno Pydantic.
  • Recursos: una plantilla de URI registrada para documentos.
  • Versiones de especificación aceptadas: 2025-03-26, 2025-06-18, 2025-11-25.

Desarrollo

uv sync
uv run pytest
uv run ruff check .

mcp-name: io.github.SpaceFrontiers/mcp

Compatibilidad

Las cuentas y claves API existentes funcionan sin cambios. El servidor alojado aún acepta llamadas de herramientas heredadas spacefrontiers_* y el antiguo endpoint https://mcp.spacefrontiers.org; las nuevas configuraciones deben usar los nombres machinelibrary y https://mcp.machinelibrary.ai.

Licencia

MIT