Cashpilot Mcp

本地服务

github.com金融数据31 天前更新

代码仓库访问官网

关于 Cashpilot Mcp

Cashpilot Mcp 将现有 CashPilot 实例接入 MCP 客户端，适用于监控被动收入和管理 DePIN 服务集群。它结合收益与集群信息查看及服务控制工具，并支持只读模式。

主要功能

01查看收益总额、明细和历史
02检查已部署服务与工作器
03查看健康评分和采集告警
04控制服务并触发采集
05通过工具和资源访问集群数据
06以只读模式限制操作

适用场景

01汇总查看各服务收益
02检查工作器和容器状态
03排查采集错误和服务日志
04部署或重启集群服务

MCP 相关

向 MCP 客户端提供 CashPilot 收益、集群详情和服务管理操作；集群信息也通过 `cashpilot://` 资源提供。它使用 API 密钥通过 stdio 或 Streamable HTTP 连接用户的 CashPilot 实例。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cashpilot": {
      "command": "npx",
      "args": [
        "-y",
        "cashpilot-mcp"
      ],
      "env": {
        "CASHPILOT_URL": "<CASHPILOT_URL>",
        "CASHPILOT_API_KEY": "<CASHPILOT_API_KEY>",
        "CASHPILOT_READ_ONLY": "<CASHPILOT_READ_ONLY>",
        "TRANSPORT": "<TRANSPORT>"
      }
    }
  }
}

启动命令npx -y cashpilot-mcp

需要配置的环境变量

CASHPILOT_URLCashPilot instance URL (e.g. http://localhost:8080)

CASHPILOT_API_KEY密钥CashPilot API key: the admin key (CASHPILOT_ADMIN_API_KEY) for full control, or the read-only key (CASHPILOT_READONLY_API_KEY) together with CASHPILOT_READ_ONLY=1. Not the fleet key.

CASHPILOT_READ_ONLYSet to true (or 1) to register only the tools that change nothing (no start, stop, restart, deploy, remove or collection)

TRANSPORTRuns the image on stdio instead of its default HTTP listener

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmcashpilot-mcp0.3.0stdio

ocidrumsergio/cashpilot-mcp:v0.3.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

cashpilot-mcp

一个轻量级桥接工具，可将任意 CashPilot 实例接入为 MCP 服务，让大模型能够监控被动收入、管理服务并控制集群工作进程。

它通过 API 密钥，经由 stdio 或 Streamable HTTP 连接到你自己的 CashPilot 实例。

同一个二进制文件支持 MCP 2026-07-28 及之前的所有版本，最早可追溯到 2024-11-05：仍使用 initialize 握手的当前客户端（Claude Code、Claude Desktop、Cursor、VS Code）和 2026-07-28 客户端（server/discover、无状态请求）均可正常工作。

功能

收益：总额、各服务余额及提现资格、每日数据序列和历史记录。
集群：已部署的服务、可部署目录、工作进程、健康评分和采集器警报，既可作为工具使用，也可作为 cashpilot:// 资源访问。
可控制任意工作进程上的服务：启动、停止、重启、部署、移除、查看日志，还可使用 trigger_collection，并按架构导出 Docker Compose 配置。
只读模式：CASHPILOT_READ_ONLY=true 时，仅注册不会产生更改的工具。
每个工具都有标题和只读／破坏性操作提示；列表工具会返回结构化 JSON，输入均经过验证。
HTTP 模式监听 127.0.0.1:8081，会检查 Origin、限制请求大小，并要求任何非回环地址都必须提供 MCP_AUTH_TOKEN。

安装

所有示例都通过 stdio 运行 npm 包。要获得完整控制权限，请使用管理员密钥（CASHPILOT_ADMIN_API_KEY）；如需只读访问，请使用只读密钥（CASHPILOT_READONLY_API_KEY）并设置 CASHPILOT_READ_ONLY=true。切勿使用集群密钥。

Claude Code

claude mcp add --transport stdio --env CASHPILOT_URL=http://localhost:8080 --env CASHPILOT_API_KEY=<key> cashpilot -- npx -y cashpilot-mcp

Claude Desktop（claude_desktop_config.json）和 Cursor（~/.cursor/mcp.json 或 .cursor/mcp.json）

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

VS Code（.vscode/mcp.json；VS Code 会询问一次密钥并将其保存）

{
  "inputs": [
    { "id": "cashpilot-key", "type": "promptString", "description": "CashPilot API key", "password": true }
  ],
  "servers": {
    "cashpilot": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "cashpilot-mcp"],
      "env": { "CASHPILOT_URL": "http://localhost:8080", "CASHPILOT_API_KEY": "${input:cashpilot-key}" }
    }
  }
}

Codex（~/.codex/config.toml）

[mcp_servers.cashpilot]
command = "npx"
args = ["-y", "cashpilot-mcp"]
env = { CASHPILOT_URL = "http://localhost:8080", CASHPILOT_API_KEY = "<key>" }

Docker、HTTP 服务和本地构建的说明请参阅入门指南；所有变量均列于配置。

工具

工具	功能	是否更改机群
`get_earnings_summary`	汇总：今日、本月、累计	否
`get_earnings_breakdown`	各项服务的余额和提现资格	否
`get_earnings_daily`	每天的总额，1 至 365 天	否
`get_earnings_history`	一周、一个月、一年或全部记录	否
`list_deployed_services`	各服务的运行位置、状态和资源	否
`list_available_services`	可部署目录及各服务所需的环境变量键	否
`get_fleet_summary`	在线和总计的 Worker 与容器数量	否
`list_workers`	`worker_id` 对应的 Worker ID	否
`get_health_scores`	各服务过去 1 至 90 天的健康评分	否
`get_collector_alerts`	上次收益采集中的错误	否
`get_service_logs`	最新容器日志行（不可信内容）	否
`get_compose`	适用于 amd64、arm64 或 arm 的 docker-compose.yml	否
`trigger_collection`	立即在后台采集收益	是
`start_service` / `restart_service`	启动或重启容器	是
`stop_service`	停止容器；停止后将不再产生收益	是，有破坏性
`deploy_service`	使用环境变量、主机名和实例部署或重新部署	是，有破坏性
`remove_service`	移除部署；保留卷	是，有破坏性