CashPilot MCP

CashPilot-MCP

Un pequeño puente que expone cualquier instancia de CashPilot como un servidor MCP, permitiendo a los LLMs monitorear ingresos pasivos, gestionar servicios y controlar trabajadores de flota.

---

Lo que obtienes

Tipo	Para qué se usa	URI MCP / ID de herramienta
Recursos	Explorar ingresos, servicios, estado de flota y puntuaciones de salud en solo lectura	cashpilot://earnings/summary cashpilot://earnings/breakdown cashpilot://services/deployed cashpilot://services/catalog cashpilot://fleet/summary cashpilot://workers cashpilot://health/scores cashpilot://collector-alerts
Herramientas	Consultar ingresos, gestionar servicios y activar la recolección	get_earnings_daily get_earnings_history get_service_logs restart_service stop_service start_service deploy_service remove_service trigger_collection get_compose

Todo se expone a través de un único endpoint JSON-RPC (/mcp). Los LLMs / Agentes pueden: initialize -> readResource -> listTools -> callTool ... y así sucesivamente.

---

Inicio 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 seguridad: El transporte HTTP escucha en 127.0.0.1:8081 por defecto. Si necesitas exponerlo en una red, colócalo detrás de un proxy inverso con autenticación.

Instalar vía npm (transporte stdio)

npx cashpilot-mcp

O instalar globalmente:

npm install -g cashpilot-mcp
cashpilot-mcp

Esto descarga el binario Go precompilado desde GitHub Releases para tu plataforma y lo ejecuta con transporte stdio. Requiere al menos una versión publicada.

Compilación 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

Configuración

Variable	Predeterminado	Descripción
CASHPILOT_URL	http://localhost:8080	URL de la instancia de CashPilot (sin / final)
CASHPILOT_API_KEY	(obligatorio)	Clave API de administrador (CASHPILOT_ADMIN_API_KEY de tu instancia de CashPilot — NO la clave de flota)
LISTEN_ADDR	127.0.0.1:8081	Dirección de escucha HTTP (Docker establece 127.0.0.1:8081)
MCP_AUTH_TOKEN	(vacío)	Token Bearer para autenticación del transporte HTTP. Obligatorio cuando LISTEN_ADDR no es loopback
TRANSPORT	(vacío = HTTP)	Establecer a stdio para transporte stdio

Colócalas en un archivo .env (desde .env.example) o configúralas en el entorno.

Pruebas

Probado con Inspector y actualmente funciona completamente. Antes de hacer un PR, asegúrate de que este servidor MCP se comporte bien a través de este medio.

Ejemplo de configuración para LLMs cliente

{
  "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 -- panel de gestión de flota de ingresos pasivos

MCP-GO -- implementación MCP moderna

GoReleaser -- lanzamientos multi-arquitectura sin complicaciones

Mantenedores

@GeiserX.

Contribuciones

¡Siéntete libre de participar! Abre un issue o envía PRs.

CashPilot-MCP sigue el Contributor Covenant Código de Conducta.

Otros Servidores MCP por GeiserX

• duplicacy-mcp — Monitoreo de salud de respaldos
• genieacs-mcp — Gestión de dispositivos TR-069
• lynxprompt-mcp — Planos de configuración de IA
• pumperly-mcp — Precios de combustible y carga de vehículos eléctricos
• telegram-archive-mcp — Archivo de mensajes de Telegram

Proyectos Relacionados

Proyecto	Descripción
CashPilot	Plataforma de ingresos pasivos autoalojada con interfaz web para configuración y seguimiento de ingresos
CashPilot-android	Agente de monitoreo Android para aplicaciones de ingresos pasivos de CashPilot
cashpilot-ha	Integración personalizada de Home Assistant para monitoreo de ingresos pasivos de CashPilot
n8n-nodes-cashpilot	Nodo comunitario de n8n para monitoreo de ingresos pasivos de CashPilot