cashpilot-mcp 是一个 MCP（Model Context Protocol）服务器，作用是作为桥接层，把任意 CashPilot 实例暴露给 LLM 使用。CashPilot 本身是一个被动收入集群管理器，而 cashpilot-mcp 让大语言模型可以监控被动收入收益、管理服务，并控制集群工作节点。
用途方面，它面向使用 CashPilot 管理带宽共享等被动收入服务的用户，希望通过 LLM 或 MCP 客户端以对话方式查看收益、操作服务。
主要能力包括：
- 只读资源：提供收益、已部署服务、服务目录、集群状态、工作节点、健康评分和收集器告警等只读资源，例如 cashpilot://earnings/summary、cashpilot://fleet/summary 等。
- 工具：支持查询每日和历史收益、读取服务日志，以及启动、停止、重启、部署或移除服务。
- trigger_collection：立即在所有服务上运行一次收益收集。
- get_compose：返回某个服务的 Docker Compose 定义。
使用方式方面，它通过管理员 API 密钥与用户自己的 CashPilot 实例通信，密钥为 CashPilot 的管理员 API 密钥（不是集群密钥）。通信支持 HTTP 或 stdio：使用 HTTP 时通过单一 JSON-RPC 端点 /mcp，使用 stdio 时设置 TRANSPORT=stdio。默认监听 127.0.0.1:8081，当需要对外暴露时，可用 MCP_AUTH_TOKEN 添加 bearer 认证。它提供 Docker 镜像、npm 包（npx cashpilot-mcp）和多架构 Go 二进制。在 MCP 客户端（如 Claude Desktop、Claude Code、Cursor）中注册 npm 包即可，npx 会以 stdio 方式运行。
适用场景主要是希望将 CashPilot 的收益监控和服务管理接入 LLM 工作流的用户，例如通过 Claude 或 Cursor 等客户端以自然语言查看收益、管理服务。
限制方面，项目采用 GPL-3.0-or-later 许可证。关于具体支持的操作系统、依赖版本、性能表现、收费模式等细节，资料中暂未提供。
