CashPilot MCP

cashpilot-mcp

Uma ponte mínima que expõe qualquer instância do CashPilot como um servidor MCP, permitindo que LLMs monitorem ganhos de renda passiva, gerenciem serviços e controlem trabalhadores da frota.

Ele conversa com sua própria instância do CashPilot usando a chave de API de administrador, via HTTP ou stdio.

Recursos

• Recursos somente leitura para ganhos, serviços implantados, catálogo, status da frota, trabalhadores, pontuações de saúde e alertas de coletores (cashpilot://earnings/summary, cashpilot://fleet/summary, ...).
• Ferramentas para consultar ganhos diários e históricos, ler logs de serviços e iniciar, parar, reiniciar, implantar ou remover serviços.
• trigger_collection executa uma coleta de ganhos em todos os serviços agora; get_compose retorna a definição Docker Compose de um serviço.
• Um endpoint JSON-RPC (/mcp) via HTTP, ou stdio com TRANSPORT=stdio.
• Escuta em 127.0.0.1:8081 por padrão; MCP_AUTH_TOKEN adiciona autenticação bearer quando você o expõe.
• Distribuído como imagem Docker, pacote npm (npx cashpilot-mcp) e binários Go multi-arquitetura.

Início rápido

Registre o pacote npm no seu cliente MCP (Claude Desktop, Claude Code, Cursor); npx o executa via stdio:

{
  "mcpServers": {
    "cashpilot": {
      "command": "npx",
      "args": ["-y", "cashpilot-mcp"],
      "env": {
        "CASHPILOT_URL": "http://localhost:8080",
        "CASHPILOT_API_KEY": "<your CASHPILOT_ADMIN_API_KEY>"
      }
    }
  }
}

A chave é a chave de API de administrador do CashPilot, não a chave da frota. Docker Compose, o servidor HTTP e builds locais estão em Introdução.

Documentação

• Introdução: Docker Compose, npm, build local
• Configuração: variáveis de ambiente e configuração do cliente MCP
• Uso: recursos e ferramentas
• Desenvolvimento: testes, contribuições, créditos
• Projetos relacionados: listagens da família e do registro

Projetos relacionados

CashPilot, o gerenciador de frota de renda passiva com o qual este servidor conversa.

Licença

GPL-3.0-or-later