AI Usage Monitor

Claude Code, OpenAI 사용량을 수집/저장하고 Claude Code 안에서 MCP tool로 조회할 수 있는 마이크로 모니터링 서비스.

Architecture

Claude Code → MCP tool 호출 → MCP Server (로컬)
                                  ├─ Claude OAuth token (로컬 파일)
                                  ├─ OpenAI Admin Key (env)
                                  ├─ 각 API에서 사용량 fetch
                                  ├─ Workers에 snapshot push (영속 저장)
                                  └─ Workers에서 히스토리 query → 결과 반환

MCP Tools

| Tool | Description | |------|-------------| | get_usage | 현재 사용량 조회 (Claude/OpenAI/both) | | get_history | 히스토리 조회 (provider, since, limit 필터) | | compare_providers | Claude vs OpenAI 비교 분석 |

Setup

1. Cloudflare Workers

npx wrangler login
npx wrangler d1 create ai-usage-monitor-db
# wrangler.toml의 database_id를 업데이트
npx wrangler d1 execute ai-usage-monitor-db --file=schema.sql
npx wrangler secret put API_KEY
npm run deploy

2. MCP Server 등록

~/.claude/settings.json:

{
  "mcpServers": {
    "ai-usage-monitor": {
      "command": "node",
      "args": ["/absolute/path/to/ai-usage-monitor/dist/mcp.mjs"],
      "env": {
        "WORKER_URL": "https://ai-usage-monitor.YOUR_SUBDOMAIN.workers.dev",
        "WORKER_API_KEY": "your-api-key",
        "OPENAI_ADMIN_KEY": "sk-admin-..."
      }
    }
  }
}

3. OpenAI Admin Key

OpenAI Admin API Keys에서 발급.

Development

npm install
npm run build          # Build both worker + MCP
npm run build:worker   # Worker only
npm run build:mcp      # MCP only
npx wrangler dev       # Local Workers dev server

Workers API

| Method | Path | Auth | Description | |--------|------|------|-------------| | GET | /health | No | Health check | | POST | /api/snapshots | Yes | Push snapshot | | GET | /api/snapshots?provider=claude&since=7d&limit=100 | Yes | Query history | | GET | /api/dashboard | Yes | Latest per provider |