APISelf

Aplicativos desktop locais servidos como ferramentas MCP a partir de um único endpoint na sua própria máquina.

Documentação

APISelf MCP

Aplicativos desktop locais, servidos ao seu agente de IA como ferramentas MCP a partir de um único endpoint na sua própria máquina.

A maioria dos servidores MCP encapsula uma API em nuvem. Estes encapsulam aplicativos que fazem coisas na própria máquina: transcrição Whisper, gravação de tela, geração de imagens e vídeos, conversão de documentos, transferência de arquivos ponto a ponto, notificações.


Experimente sem instalar nada

Há um servidor hospedado, somente leitura, que permite a um agente navegar pelo catálogo antes de você instalar qualquer coisa. Quatro ferramentas, sem conta, sem configuração local:

claude mcp add --transport http apiself-catalogue https://apiself.com/mcp
FerramentaO que faz
list_boxesCada caixa com tagline, categoria e maturidade
get_boxUma caixa completa: o que faz, preço por nível, requisitos
search_boxesEncontre caixas pelo que fazem, ex.: "transcrever fala", "códigos QR"
get_install_commandO comando de instalação exato para uma determinada plataforma

Essa é a vitrine. O restante desta página é a coisa em si.


O endpoint local

Instale o APISelf Manager, instale as caixas que desejar, e cada uma delas aparece como ferramentas MCP em:

http://127.0.0.1:7474/api/mcp

Instale outra caixa e suas ferramentas aparecem lá sem configuração. Remova-a e elas desaparecem. Não há código MCP por caixa para escrever ou manter sincronizado.

Instalando o Manager

# Linux
curl -fsSL https://apiself.com/install/en/setup.sh | bash

# macOS
curl -fsSL https://apiself.com/install/en/setup-macos.sh | bash

# Windows (PowerShell)
irm https://apiself.com/install/en/install-windows.ps1 | iex

O Manager roda em localhost:7474. Configurações → Integração de IA imprime a configuração pronta para cada cliente abaixo, com o token de sessão preenchido.

Conectando um cliente

Claude Code — um comando, sem arquivo de configuração:

claude mcp add --transport http apiself http://127.0.0.1:7474/api/mcp \
  --header "X-APISelf-Token: <MANAGER_SESSION_TOKEN>"

Cursormcp.json:

{
  "mcpServers": {
    "apiself": {
      "url": "http://127.0.0.1:7474/api/mcp",
      "headers": { "X-APISelf-Token": "<MANAGER_SESSION_TOKEN>" }
    }
  }
}

Claude Desktop — via mcp-remote:

{
  "mcpServers": {
    "apiself": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "http://127.0.0.1:7474/api/mcp",
        "--header", "X-APISelf-Token: <MANAGER_SESSION_TOKEN>"
      ]
    }
  }
}

Gemini CLI, GitHub Copilot e ChatGPT também são gerados para você no mesmo lugar.


O que você obtém

Cada caixa instalada contribui com suas próprias ferramentas, então o total depende do que você instalou — um catálogo completo tem várias centenas de operações. O instantâneo abaixo conta apenas endpoints de domínio, com saúde, informações e auditoria excluídos.

O catálogo muda conforme as caixas são lançadas, então trate isso como uma imagem em vez de um contrato. A lista ao vivo está em https://apiself.com/llms.txt, e a ferramenta list_boxes no servidor hospedado acima a retorna diretamente.

CaixaFerramentasO que é
AI Gateway46Um lugar para modelos e chaves de IA, locais e em nuvem
Auth37SSO autohospedado e contas para cada caixa
Notify35Notificações multicanal: e-mail, Slack, Telegram, traga sua própria chave
Video Tools35Converta, redimensione, corte e otimize vídeo localmente
Image Gen34Imagens a partir de um prompt, na sua GPU ou via sua própria chave de nuvem
Image Tools34Converta, redimensione e otimize imagens localmente
S3 Bridge29Uma API S3 local na frente de qualquer backend de armazenamento
Text to Speech28Síntese de voz local, sem taxas por caractere
Video Gen28Vídeo de IA a partir de um prompt via sua própria chave de nuvem
Storage25Gateway de armazenamento: S3, SFTP, Dropbox, WebDAV
Recorder23Gravação de tela e microfone
AI Chat18Converse com modelos locais e em nuvem sobre seus próprios documentos (RAG)
Forms17Construtor de formulários autohospedado
Scan Codes17Leitura e geração de QR e códigos de barras, lote offline
Reel Forge16Prompt para vídeo curto finalizado: roteiro, voz, legendas
Doc Tools14Conversão de documentos e edição de PDF
Transcribe14Transcrição Whisper local, totalmente offline
File Drop11Compartilhamento de arquivos ponto a ponto, sem upload para qualquer servidor

O problema da contagem de ferramentas

Várias centenas de ferramentas afogam um agente. O contexto se enche de definições que a tarefa nunca usará, e a precisão da seleção cai muito antes do limite da janela de contexto.

Acima de um limite, o servidor para de retornar o catálogo completo de tools/list e retorna três meta-ferramentas em vez disso:

FerramentaO que faz
search_toolsEncontre ferramentas pelo que você quer fazer
call_toolInvoque uma pelo nome
list_boxesO que está instalado e para que serve cada caixa

O agente busca o que uma tarefa precisa e puxa apenas isso. As ferramentas do próprio Manager permanecem diretamente disponíveis em ambos os modos, porque uma solicitação como "instale a caixa de código QR" não deve exigir uma etapa de busca primeiro.

O limite é 50 por padrão e é configurável:

APISELF_MCP_TOOL_SEARCH_THRESHOLD=120   # raise it
APISELF_MCP_TOOL_SEARCH_THRESHOLD=0     # always return the full list
APISELF_MCP_TOOL_SEARCH_THRESHOLD=-1    # always search

Como as ferramentas são geradas

Cada caixa acompanha um documento OpenAPI descrevendo sua API REST. O Manager lê esses documentos na inicialização e deriva as definições de ferramentas MCP deles, então:

  • adicionar um endpoint a uma caixa adiciona uma ferramenta, sem código MCP em lugar nenhum
  • as descrições das ferramentas vêm das descrições da API e permanecem sincronizadas por construção
  • os nomes das ferramentas são prefixados por caixa, ex.: transcribe__post_api_transcribe
  • as descrições são servidas no idioma do Manager, não apenas em inglês

As caixas também se chamam umas às outras pelas mesmas APIs REST, então um agente pedindo a uma caixa para passar trabalho para outra está usando um caminho que já existe, em vez de um construído para agentes.


Onde as coisas rodam

Tudo está em 127.0.0.1 em uma instalação desktop: sem listener de LAN, nada para nmap encontrar. Instalado via SSH em uma máquina Linux sem display, o Manager detecta isso, vincula 0.0.0.0 e habilita acesso LAN para que você possa alcançá-lo de outro computador. Qualquer padrão pode ser alterado durante a primeira execução ou depois nas configurações.

Caixas com recursos de IA acompanham um modelo local como padrão. Modelos em nuvem são traga-sua-própria-chave: a chave vai para a caixa AI Gateway, o único lugar onde uma é armazenada, e outras caixas roteiam por ela sem nunca vê-la.


Coisas que vale a pena saber antes de instalar

É código fechado. É um produto pago de uma pessoa e não há versão de abri-lo que sobreviva a isso. O que é verdade em vez disso: seus dados ficam no seu próprio disco como SQLite simples e arquivos comuns, e a interface HTTP de cada caixa é documentada, então nada fica preso se o APISelf desaparecer.

Os aplicativos são pagos, com um nível gratuito que não expira. Quando um teste termina, a caixa degrada para Gratuito em vez de parar, e nada que você criou é perdido. O próprio Manager é gratuito.

Os binários ainda não são assinados com código. O Windows mostra um aviso do SmartScreen e o macOS Gatekeeper pede confirmação no primeiro lançamento. É um custo ainda não coberto e a primeira coisa que será paga.

Não há sandbox. Uma caixa roda como um processo normal sob sua conta de usuário, o mesmo que qualquer aplicativo desktop que você instala.


Links

Perguntas sobre o mapeamento OpenAPI-para-MCP ou a abordagem de busca de ferramentas são bem-vindas como issues aqui.