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.

---

O que você obtém

Tipo	Para que serve	URI MCP / ID da ferramenta
Recursos	Navegue por ganhos, serviços, status da frota e pontuações de saúde somente leitura	cashpilot://earnings/summary cashpilot://earnings/breakdown cashpilot://services/deployed cashpilot://services/catalog cashpilot://fleet/summary cashpilot://workers cashpilot://health/scores cashpilot://collector-alerts
Ferramentas	Consulte ganhos, gerencie serviços e acione a coleta	get_earnings_daily get_earnings_history get_service_logs restart_service stop_service start_service deploy_service remove_service trigger_collection get_compose

Tudo é exposto por meio de um único endpoint JSON-RPC (/mcp). LLMs / Agentes podem: initialize -> readResource -> listTools -> callTool ... e assim por diante.

---

Início rápido (Docker Compose)

services:
  cashpilot-mcp:
    image: drumsergio/cashpilot-mcp:latest
    ports:
      - "127.0.0.1:8081:8081"
    environment:
      - CASHPILOT_URL=http://cashpilot:8080
      - CASHPILOT_API_KEY=<your-CASHPILOT_ADMIN_API_KEY>

Nota de segurança: O transporte HTTP escuta em 127.0.0.1:8081 por padrão. Se você precisar expô-lo em uma rede, coloque-o atrás de um proxy reverso com autenticação.

Instalar via npm (transporte stdio)

npx cashpilot-mcp

Ou instale globalmente:

npm install -g cashpilot-mcp
cashpilot-mcp

Isso baixa o binário Go pré-compilado dos GitHub Releases para sua plataforma e o executa com transporte stdio. Requer pelo menos um release publicado.

Build local

git clone https://github.com/GeiserX/cashpilot-mcp
cd cashpilot-mcp

# (optional) create .env from the sample
cp .env.example .env && $EDITOR .env

go run ./cmd/server

Configuração

Variável	Padrão	Descrição
CASHPILOT_URL	http://localhost:8080	URL da instância do CashPilot (sem / no final)
CASHPILOT_API_KEY	(obrigatório)	Chave da API de administração (CASHPILOT_ADMIN_API_KEY da sua instância do CashPilot — NÃO a chave da frota)
LISTEN_ADDR	127.0.0.1:8081	Endereço de escuta HTTP (o Docker define 127.0.0.1:8081)
MCP_AUTH_TOKEN	(vazio)	Token Bearer para autenticação do transporte HTTP. Obrigatório quando LISTEN_ADDR não é loopback
TRANSPORT	(vazio = HTTP)	Defina como stdio para transporte stdio

Coloque-os em um arquivo .env (a partir de .env.example) ou defina-os no ambiente.

Testes

Testado com Inspector e atualmente totalmente funcional. Antes de fazer um PR, certifique-se de que este servidor MCP se comporta bem por esse meio.

Exemplo de configuração para LLMs clientes

{
  "schema_version": "v1",
  "name_for_human": "CashPilot-MCP",
  "name_for_model": "cashpilot_mcp",
  "description_for_human": "Monitor passive income earnings, manage bandwidth-sharing services, and control fleet workers via CashPilot.",
  "description_for_model": "Interact with a CashPilot instance that manages passive income services. First call initialize, then reuse the returned session id in header \"Mcp-Session-Id\" for every other call. Use readResource to fetch URIs that begin with cashpilot://. Use listTools to discover available actions and callTool to execute them.",
  "auth": {
    "type": "bearer",
    "token": "<your-MCP_AUTH_TOKEN>"
  },
  "api": {
    "type": "jsonrpc-mcp",
    "url":  "http://localhost:8081/mcp",
    "init_method": "initialize",
    "session_header": "Mcp-Session-Id"
  },
  "contact_email": "acsdesk@protonmail.com",
  "legal_info_url": "https://github.com/GeiserX/cashpilot-mcp/blob/main/LICENSE"
}

Créditos

CashPilot -- painel de gerenciamento de frota de renda passiva

MCP-GO -- implementação MCP moderna

GoReleaser -- releases multi-arquitetura sem dor

Mantenedores

@GeiserX.

Contribuindo

Sinta-se à vontade para mergulhar! Abra uma issue ou envie PRs.

CashPilot-MCP segue o Código de Conduta do Contributor Covenant.

Outros Servidores MCP por GeiserX

• duplicacy-mcp — Monitoramento de saúde de backups
• genieacs-mcp — Gerenciamento de dispositivos TR-069
• lynxprompt-mcp — Blueprints de configuração de IA
• pumperly-mcp — Preços de combustível e carregamento de veículos elétricos
• telegram-archive-mcp — Arquivo de mensagens do Telegram

Projetos Relacionados

Projeto	Descrição
CashPilot	Plataforma de renda passiva auto-hospedada com interface web para configuração e rastreamento de ganhos
CashPilot-android	Agente de monitoramento Android para aplicativos de renda passiva do CashPilot
cashpilot-ha	Integração personalizada do Home Assistant para monitoramento de renda passiva do CashPilot
n8n-nodes-cashpilot	Nó da comunidade n8n para monitoramento de renda passiva do CashPilot