Space Frontiers

Interage com a API do Space Frontiers, permitindo que modelos de linguagem interajam com suas fontes de dados.

GitHub
11
Experimente este MCPPatrocinado

Documentação

Servidor MCP da Machine Library

Servidor MCP oficial da Machine Library, o produto de busca e IA da Space Frontiers Company.

  • Endpoint: https://mcp.machinelibrary.ai (canônico)
  • Nome do servidor: machinelibrary; as ferramentas são prefixadas com machinelibrary_
  • Guia de instalação para agentes: https://machinelibrary.ai/install.md

Uma camada de recuperação para agentes de IA sobre artigos revisados por pares, livros, patentes, normas, Wikipedia, Reddit, Telegram, Discord e YouTube. Retorna texto completo limitado e URIs de origem canônicas para citação.

Hospedado em https://mcp.machinelibrary.ai/ (transporte HTTP Streamable, OAuth 2.1 com PKCE ou chave de API Bearer).

Experimente um exemplo prático: Encontre pesquisas, inspecione passagens de apoio e mantenha citações. Inclui chamadas de ferramentas exatas e observações de uma execução real, além de uma pequena lista de verificação de avaliação para equipes de pesquisa.

Machine Library MCP

Ferramentas

As quatro ferramentas principais de recuperação abaixo são somente leitura, idempotentes e prefixadas com machinelibrary_ para evitar colisões em configurações de agentes com múltiplos servidores. Este repositório as implementa. O servidor hospedado também expõe machinelibrary_research (respostas de pesquisa com citações), machinelibrary_search_feedback, machinelibrary_comment_on_document e machinelibrary_top_up_balance (compra de créditos pré-pagos; não são somente leitura); consulte o guia de ferramentas ou seu tools/list.

FerramentaQuando usar
machinelibrary_search_documentsArtigos, livros, patentes, normas, Wikipedia, transcrições do YouTube. Use para citações e estado da técnica.
machinelibrary_search_socialReddit, canais do Telegram, Discord. Use para notícias e discussões da comunidade.
machinelibrary_fetch_documentTexto completo limitado + até 50 referências para uma URI canônica. Padrão de 40 mil caracteres; suporta até 100 mil.
machinelibrary_search_in_documentAté cinco passagens correspondentes dentro de um documento. Use para documentos com mais de ~20 mil tokens.

A busca padrão retorna 10 resultados compactos, classificados de forma híbrida, e é limitada a 30. Cada resultado inclui um source_uri canônico, um trecho (até 900 caracteres), uma prévia do resumo (até 800 caracteres), pontuação, autores, data, tipo e tamanho estimado do texto completo. Os backlinks de citação são opcionais no machinelibrary_fetch_document porque adicionam outra busca cobrada.

Instalação

O servidor hospedado tem sua própria página de instalação /mcp com links de um clique para Cursor, VS Code e Smithery.

Claude Code (recomendado)

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

No primeiro uso, um navegador abre para login OAuth — sem necessidade de colar chave de API.

Cursor / VS Code / Cline / Windsurf (HTTP)

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

Obtenha uma chave de API em https://machinelibrary.ai/keys.

Auto-hospedado (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

A variável de ambiente é usada como credencial da API upstream no modo stdio. O comando seleciona a API pública da Machine Library com SEARCH_API_ENDPOINT. O padrão interno permanece http://search-api para implantações existentes. Para implantações HTTP, defina SEARCH_API_ENDPOINT para sua API de busca interna confiável e USERS_API_ENDPOINT para sua API de usuários interna; o middleware de autenticação encaminha cabeçalhos de identidade verificados para esse serviço interno. O OAuth usa o servidor de autorização https://api.machinelibrary.ai e login pelo navegador em https://machinelibrary.ai.

Preços

  • Busca: US$ 0,01 base + US$ 0,001 por resultado retornado (o padrão MCP de 10 resultados custa US$ 0,02).
  • Busca de documento completo: US$ 0,05.
  • Busca de passagens dentro do documento: US$ 0,015.
  • referenced_by_limit > 0 em uma busca adiciona uma busca cobrada separadamente.

Adicione créditos em https://machinelibrary.ai/payments.

Estrutura do repositório

  • mcp_server.py — ponto de entrada Starlette + FastMCP, endpoints OAuth well-known.
  • tools.py — quatro ferramentas com esquemas de saída Pydantic.
  • prompts.py — prompt deep_research_agent.
  • resources.py — modelo de URI spacefrontiers://document/{uri_b64}.
  • auth.py — validação de token Bearer, lista de permissões de origem, verificação de MCP-Protocol-Version.
  • client.py — cliente HTTP assíncrono para a API de busca v2.
  • server.json — entrada do Registro Oficial MCP.
  • smithery.yaml — configuração de implantação Smithery.
  • registry.json — metadados do registro interno.
  • tests/ — testes unitários pytest.

Conformidade com a especificação

  • Transporte: HTTP Streamable, sem estado.
  • Autenticação: OAuth 2.1 com Registro Dinâmico de Cliente RFC 7591; chaves de API de longa duração também são aceitas.
  • Anotações: cada ferramenta declara readOnlyHint, idempotentHint, openWorldHint, destructiveHint:false.
  • Esquemas de saída: o outputSchema de cada ferramenta é gerado automaticamente a partir de um modelo de retorno Pydantic.
  • Recursos: um modelo de URI registrado para documentos.
  • Versões de especificação aceitas: 2025-03-26, 2025-06-18, 2025-11-25.

Desenvolvimento

uv sync
uv run pytest
uv run ruff check .

mcp-name: io.github.SpaceFrontiers/mcp

Compatibilidade

Contas e chaves de API existentes funcionam sem alterações. O servidor hospedado ainda aceita chamadas de ferramentas legadas spacefrontiers_* e o antigo endpoint https://mcp.spacefrontiers.org; novas configurações devem usar os nomes machinelibrary e https://mcp.machinelibrary.ai.

Licença

MIT