ccusage 0.4.1 → 0.5.0

package/README.md

@@ -73,6 +73,12 @@ npx ccusage@latest
 
 # Using bunx
 bunx ccusage
+
+# Using pnpm
+pnpm dlx ccusage
+
+# Using Deno with security flags
+deno run -E -R=$HOME/.claude/projects/ -S=homedir -N='raw.githubusercontent.com:443' npm:ccusage@latest
 ```
 
 ### Local Installation
@@ -175,6 +181,68 @@ All commands support the following options:
 - **`calculate`**: Always calculates costs from token counts using model pricing, ignores any pre-calculated `costUSD` values
 - **`display`**: Always uses pre-calculated `costUSD` values only, shows $0.00 for entries without pre-calculated costs
 
+### MCP (Model Context Protocol) Support
+
+Exposes usage data through Model Context Protocol for integration with other tools:
+
+```bash
+# Start MCP server with stdio transport (for local integration)
+ccusage mcp
+
+# Start MCP server with HTTP stream transport (for remote access)
+ccusage mcp --type http --port 8080
+
+# Control cost calculation mode
+ccusage mcp --mode calculate
+```
+
+The MCP server supports both **stdio** and **HTTP stream** transports:
+- **stdio** (default): Best for local integration where the client directly spawns the process
+- **HTTP stream**: Best for remote access when you need to call the server from another machine or network location
+
+Available MCP tools:
+- `daily`: Returns daily usage reports (accepts `since`, `until`, `mode` parameters)
+- `session`: Returns session usage reports (accepts `since`, `until`, `mode` parameters)
+
+#### Claude Desktop Configuration Example
+
+<div align="center">
+  <img src="https://github.com/ryoppippi/ccusage/blob/main/docs/mcp-claude-desktop.avif?raw=true">
+</div>
+
+To use ccusage MCP with Claude Desktop, add this to your Claude Desktop configuration file:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "ccusage": {
+      "command": "npx",
+      "args": ["ccusage@latest", "mcp"],
+      "env": {}
+    }
+  }
+}
+```
+
+Or if you have ccusage installed globally:
+
+```json
+{
+  "mcpServers": {
+    "ccusage": {
+      "command": "ccusage",
+      "args": ["mcp"],
+      "env": {}
+    }
+  }
+}
+```
+
+After adding this configuration, restart Claude Desktop. You'll then be able to use the ccusage tools within Claude to analyze your usage data.
+
 ## Output Example
 
 ### Daily Report

package/dist/arktype-C-GObzDh-Dj1DVoqC.js

@@ -0,0 +1,5 @@
+//#region node_modules/xsschema/dist/arktype-C-GObzDh.js
+const getToJsonSchemaFn = async () => (schema) => schema.toJsonSchema();
+
+//#endregion
+export { getToJsonSchemaFn };

package/dist/{calculate-cost-DMC4FhU4.js → calculate-cost-2IwHSzmi.js}

@@ -1,4 +1,4 @@
-//#region calculate-cost.ts
+//#region src/calculate-cost.ts
 function calculateTotals(data) {
 	return data.reduce((acc, item) => ({
 		inputTokens: acc.inputTokens + item.inputTokens,

package/dist/calculate-cost.d.ts

@@ -1,6 +1,9 @@
-import { DailyUsage, SessionUsage, TokenData, TokenTotals } from "./data-loader-D1LHcGfa.js";
+import "./index-BurjgCfW.js";
+import "./pricing-fetcher-DygIroMj.js";
+import { TokenData, TokenTotals } from "./types-B3ib19os.js";
+import { DailyUsage, SessionUsage } from "./data-loader-LMCrJ-lW.js";
 
-//#region calculate-cost.d.ts
+//#region src/calculate-cost.d.ts
 declare function calculateTotals(data: Array<DailyUsage | SessionUsage>): TokenTotals;
 declare function getTotalTokens(tokens: TokenData): number;
 declare function createTotalsObject(totals: TokenTotals): {

package/dist/calculate-cost.js

@@ -1,3 +1,3 @@
-import { calculateTotals, createTotalsObject, getTotalTokens } from "./calculate-cost-DMC4FhU4.js";
+import { calculateTotals, createTotalsObject, getTotalTokens } from "./calculate-cost-2IwHSzmi.js";
 
 export { calculateTotals, createTotalsObject, getTotalTokens };