convez.ai
MCP ServerFinanceiroIntermediário
GeiserX

CashPilot MCP — Gerenciador de Renda Passiva via MCP

GeiserX/cashpilot-mcp

Controle CashPilot via Claude e outros LLMs com recursos e ferramentas MCP

Ver no GitHub
BomPluginScore · de 0 a 100

MCP Server que integra qualquer instância CashPilot com LLMs para monitoramento de ganhos passivos, gerenciamento de serviços e controle de workers em frotas. Oferece recursos somente leitura para auditoria de earnings e ferramentas para automação de deployments e coletas de dados.

Instalação

$npx convez-ai GeiserX/cashpilot-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
1
Acompanhando
1
Saúde
57%
Último commit
há 1 dia
Versão
v0.3.2
Issues abertas
0
Contribuidores
2

Casos de uso

  • Monitorar ganhos passivos e histórico de earnings em tempo real
  • Automatizar deploy e reinicialização de serviços via Claude
  • Auditar saúde de fleet workers e scores de performance

Veredito

MCP Server sólido (Go 1.24, oficial registry) para ecossistemas CashPilot — bem documentado e com bom suporte a recursos + ferramentas. Recomendado para times que operam renda passiva e precisam de automação via LLMs.

README

A tradução para o português deste README ainda está na fila.


What you get

TypeWhat forMCP URI / Tool id
ResourcesBrowse earnings, services, fleet status, and health scores read-onlycashpilot://earnings/summarycashpilot://earnings/breakdowncashpilot://services/deployedcashpilot://services/catalogcashpilot://fleet/summarycashpilot://workerscashpilot://health/scorescashpilot://collector-alerts
ToolsQuery earnings, manage services, and trigger collectionget_earnings_dailyget_earnings_historyget_service_logsrestart_servicestop_servicestart_servicedeploy_serviceremove_servicetrigger_collectionget_compose

Everything is exposed over a single JSON-RPC endpoint (/mcp). LLMs / Agents can: initialize -> readResource -> listTools -> callTool ... and so on.


Quick-start (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>

Security note: The HTTP transport listens on 127.0.0.1:8081 by default. If you need to expose it on a network, place it behind a reverse proxy with authentication.

Install via npm (stdio transport)

npx cashpilot-mcp

Or install globally:

npm install -g cashpilot-mcp
cashpilot-mcp

This downloads the pre-built Go binary from GitHub Releases for your platform and runs it with stdio transport. Requires at least one published release.

Local build

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

Configuration

VariableDefaultDescription
CASHPILOT_URLhttp://localhost:8080CashPilot instance URL (without trailing /)
CASHPILOT_API_KEY(required)Admin API key (CASHPILOT_ADMIN_API_KEY from your CashPilot instance — NOT the fleet key)
LISTEN_ADDR127.0.0.1:8081HTTP listen address (Docker sets 127.0.0.1:8081)
MCP_AUTH_TOKEN(empty)Bearer token for HTTP transport auth. Required when LISTEN_ADDR is not loopback
TRANSPORT(empty = HTTP)Set to stdio for stdio transport

Put them in a .env file (from .env.example) or set them in the environment.

Testing

Tested with Inspector and it is currently fully working. Before making a PR, make sure this MCP server behaves well via this medium.

Example configuration for client LLMs

{
  "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"
}

Credits

CashPilot -- passive income fleet management dashboard

MCP-GO -- modern MCP implementation

GoReleaser -- painless multi-arch releases

Maintainers

@GeiserX.

Contributing

Feel free to dive in! Open an issue or submit PRs.

CashPilot-MCP follows the Contributor Covenant Code of Conduct.

Other MCP Servers by GeiserX

Related Projects

ProjectDescription
CashPilotSelf-hosted passive income platform with web UI for setup and earnings tracking
CashPilot-androidAndroid monitoring agent for CashPilot passive income apps
cashpilot-haHome Assistant custom integration for CashPilot passive income monitoring
n8n-nodes-cashpilotn8n community node for CashPilot passive income monitoring
Ver o original no GitHub

Bom para

Relacionados