ecoflow-token-usage-mcp

MCP server for querying your personal token balance and usage on llmapi.ecoflow.com. Exposes a single tool, get_token_usage, that returns remaining and consumed tokens together with their RMB equivalents.

Install & configure

Once published to PyPI, point any MCP client at uvx:

{
  "mcpServers": {
    "ecoflow-token-usage": {
      "command": "uvx",
      "args": ["ecoflow-token-usage-mcp"],
      "env": {
        "ANTHROPIC_AUTH_TOKEN": "sk-..."
      }
    }
  }
}

If ANTHROPIC_AUTH_TOKEN is not set in env, the server falls back to ~/.claude/settings.json and reads .env.ANTHROPIC_AUTH_TOKEN (the same field Claude Code uses).

Tool

get_token_usage

No arguments. Returns a JSON string:

{
  "name": "bin.ling",
  "total_available_tokens": 12345678,
  "total_used_tokens": 9876543,
  "available_rmb": 167.92,
  "used_rmb": 134.32,
  "tokens_per_rmb": 73529
}

Local development

git clone <this-repo>
cd token-usage-mcp
uv sync
uv run pytest -v

Run the server directly for ad-hoc testing:

uv run ecoflow-token-usage-mcp

Build & publish

uv build                 # produces dist/*.whl and dist/*.tar.gz
uv publish               # uploads to PyPI (requires API token)
git tag v0.1.0 && git push --tags

License

MIT — see LICENSE.