@ccusage/mcp 0.0.1 → 17.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ryoppippi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,15 +1,82 @@
-# mk
+<div align="center">
+    <img src="https://cdn.jsdelivr.net/gh/ryoppippi/ccusage@main/docs/public/logo.svg" alt="ccusage logo" width="256" height="256">
+    <h1>@ccusage/mcp</h1>
+</div>
 
-To install dependencies:
+<p align="center">
+    <a href="https://socket.dev/api/npm/package/@ccusage/mcp"><img src="https://socket.dev/api/badge/npm/package/@ccusage/mcp" alt="Socket Badge" /></a>
+    <a href="https://npmjs.com/package/@ccusage/mcp"><img src="https://img.shields.io/npm/v/@ccusage/mcp?color=yellow" alt="npm version" /></a>
+    <a href="https://tanstack.com/stats/npm?packageGroups=%5B%7B%22packages%22:%5B%7B%22name%22:%22@ccusage/mcp%22%7D%5D%7D%5D&range=30-days&transform=none&binType=daily&showDataMode=all&height=400"><img src="https://img.shields.io/npm/dy/@ccusage/mcp" alt="NPM Downloads" /></a>
+    <a href="https://packagephobia.com/result?p=@ccusage/mcp"><img src="https://packagephobia.com/badge?p=@ccusage/mcp" alt="install size" /></a>
+    <a href="https://deepwiki.com/ryoppippi/ccusage"><img src="https://img.shields.io/badge/DeepWiki-ryoppippi%2Fccusage-blue.svg?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACwAAAAyCAYAAAAnWDnqAAAAAXNSR0IArs4c6QAAA05JREFUaEPtmUtyEzEQhtWTQyQLHNak2AB7ZnyXZMEjXCGeK/AIi+QuHrMnbChYY7MIh8g01fJoopFb0uhhEqqcbWTp06/uv1saEDv4O3n3dV60RfP947Mm9/SQc0ICFQgzfc4CYZoTPAswgSJCCUJUnAAoRHOAUOcATwbmVLWdGoH//PB8mnKqScAhsD0kYP3j/Yt5LPQe2KvcXmGvRHcDnpxfL2zOYJ1mFwrryWTz0advv1Ut4CJgf5uhDuDj5eUcAUoahrdY/56ebRWeraTjMt/00Sh3UDtjgHtQNHwcRGOC98BJEAEymycmYcWwOprTgcB6VZ5JK5TAJ+fXGLBm3FDAmn6oPPjR4rKCAoJCal2eAiQp2x0vxTPB3ALO2CRkwmDy5WohzBDwSEFKRwPbknEggCPB/imwrycgxX2NzoMCHhPkDwqYMr9tRcP5qNrMZHkVnOjRMWwLCcr8ohBVb1OMjxLwGCvjTikrsBOiA6fNyCrm8V1rP93iVPpwaE+gO0SsWmPiXB+jikdf6SizrT5qKasx5j8ABbHpFTx+vFXp9EnYQmLx02h1QTTrl6eDqxLnGjporxl3NL3agEvXdT0WmEost648sQOYAeJS9Q7bfUVoMGnjo4AZdUMQku50McDcMWcBPvr0SzbTAFDfvJqwLzgxwATnCgnp4wDl6Aa+Ax283gghmj+vj7feE2KBBRMW3FzOpLOADl0Isb5587h/U4gGvkt5v60Z1VLG8BhYjbzRwyQZemwAd6cCR5/XFWLYZRIMpX39AR0tjaGGiGzLVyhse5C9RKC6ai42ppWPKiBagOvaYk8lO7DajerabOZP46Lby5wKjw1HCRx7p9sVMOWGzb/vA1hwiWc6jm3MvQDTogQkiqIhJV0nBQBTU+3okKCFDy9WwferkHjtxib7t3xIUQtHxnIwtx4mpg26/HfwVNVDb4oI9RHmx5WGelRVlrtiw43zboCLaxv46AZeB3IlTkwouebTr1y2NjSpHz68WNFjHvupy3q8TFn3Hos2IAk4Ju5dCo8B3wP7VPr/FGaKiG+T+v+TQqIrOqMTL1VdWV1DdmcbO8KXBz6esmYWYKPwDL5b5FA1a0hwapHiom0r/cKaoqr+27/XcrS5UwSMbQAAAABJRU5ErkJggg==" alt="DeepWiki"></a>
+    <!-- DeepWiki badge generated by https://deepwiki.ryoppippi.com/ -->
+</p>
+
+<div align="center">
+    <img src="https://cdn.jsdelivr.net/gh/ryoppippi/ccusage@main/docs/public/mcp-claude-desktop.avif" alt="Claude Desktop MCP integration screenshot" width="640">
+</div>
+
+> MCP (Model Context Protocol) server implementation for ccusage - provides Claude Code usage data through the MCP protocol.
+
+## Quick Start
 
 ```bash
-bun install
+# Using bunx (recommended for speed)
+bunx @ccusage/mcp@latest
+
+# Using npx
+npx @ccusage/mcp@latest
+
+# Start with HTTP transport
+bunx @ccusage/mcp@latest -- --type http --port 8080
 ```
 
-To run:
+## Integrations
 
-```bash
-bun run index.ts
+### Claude Desktop Integration
+
+Add to your Claude Desktop MCP configuration:
+
+```json
+{
+	"mcpServers": {
+		"ccusage": {
+			"command": "npx",
+			"args": ["@ccusage/mcp@latest"],
+			"type": "stdio"
+		}
+	}
+}
 ```
 
-This project was created using `bun init` in bun v1.2.20. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.
+### Claude Code
+
+```sh
+claude mcp add ccusage npx -- @ccusage/mcp@latest
+```
+
+## Documentation
+
+For full documentation, visit **[ccusage.com/guide/mcp-server](https://ccusage.com/guide/mcp-server)**
+
+## Sponsors
+
+### Featured Sponsor
+
+Check out [ccusage: The Claude Code cost scorecard that went viral](https://www.youtube.com/watch?v=Ak6qpQ5qdgk)
+
+<p align="center">
+    <a href="https://www.youtube.com/watch?v=Ak6qpQ5qdgk">
+        <img src="https://cdn.jsdelivr.net/gh/ryoppippi/ccusage@main/docs/public/ccusage_thumbnail.png" alt="ccusage: The Claude Code cost scorecard that went viral" width="600">
+    </a>
+</p>
+
+<p align="center">
+    <a href="https://github.com/sponsors/ryoppippi">
+        <img src="https://cdn.jsdelivr.net/gh/ryoppippi/sponsors@main/sponsors.svg">
+    </a>
+</p>
+
+## License
+
+MIT © [@ryoppippi](https://github.com/ryoppippi)

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,539 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+import process$1 from "node:process";
+import { serve } from "@hono/node-server";
+import { getClaudePaths } from "ccusage/data-loader";
+import { logger } from "ccusage/logger";
+import { cli, define } from "gunshi";
+import { StreamableHTTPTransport } from "@hono/mcp";
+import "@modelcontextprotocol/sdk/client/index.js";
+import "@modelcontextprotocol/sdk/inMemory.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import a from "node:fs/promises";
+import c from "node:path";
+import b from "node:fs";
+import F from "node:os";
+import { Hono } from "hono/tiny";
+import { z } from "zod";
+import spawn, { SubprocessError } from "nano-spawn";
+var name = "@ccusage/mcp";
+var version = "17.0.0";
+var description = "MCP server implementation for ccusage data";
+var d = Object.defineProperty;
+var n = (s, t) => d(s, "name", {
+	value: t,
+	configurable: !0
+});
+typeof Symbol.asyncDispose != "symbol" && Object.defineProperty(Symbol, "asyncDispose", {
+	configurable: !1,
+	enumerable: !1,
+	writable: !1,
+	value: Symbol.for("asyncDispose")
+});
+var P = class {
+	static {
+		n(this, "FsFixture");
+	}
+	path;
+	constructor(t) {
+		this.path = t;
+	}
+	getPath(...t) {
+		return c.join(this.path, ...t);
+	}
+	exists(t = "") {
+		return a.access(this.getPath(t)).then(() => !0, () => !1);
+	}
+	rm(t = "") {
+		return a.rm(this.getPath(t), {
+			recursive: !0,
+			force: !0
+		});
+	}
+	cp(t, r, i) {
+		return r ? r.endsWith(c.sep) && (r += c.basename(t)) : r = c.basename(t), a.cp(t, this.getPath(r), i);
+	}
+	mkdir(t) {
+		return a.mkdir(this.getPath(t), { recursive: !0 });
+	}
+	writeFile(t, r) {
+		return a.writeFile(this.getPath(t), r);
+	}
+	writeJson(t, r) {
+		return this.writeFile(t, JSON.stringify(r, null, 2));
+	}
+	readFile(t, r) {
+		return a.readFile(this.getPath(t), r);
+	}
+	async [Symbol.asyncDispose]() {
+		await this.rm();
+	}
+};
+const v = b.realpathSync(F.tmpdir()), D = `fs-fixture-${Date.now()}-${process.pid}`;
+let m = 0;
+const j = n(() => (m += 1, m), "getId");
+var u = class {
+	static {
+		n(this, "Path");
+	}
+	path;
+	constructor(t) {
+		this.path = t;
+	}
+};
+var f = class extends u {
+	static {
+		n(this, "Directory");
+	}
+};
+var y = class extends u {
+	static {
+		n(this, "File");
+	}
+	content;
+	constructor(t, r) {
+		super(t), this.content = r;
+	}
+};
+var l = class {
+	static {
+		n(this, "Symlink");
+	}
+	target;
+	type;
+	path;
+	constructor(t, r) {
+		this.target = t, this.type = r;
+	}
+};
+const w = n((s, t, r) => {
+	const i = [];
+	for (const p in s) {
+		if (!Object.hasOwn(s, p)) continue;
+		const e = c.join(t, p);
+		let o = s[p];
+		if (typeof o == "function") {
+			const g = Object.assign(Object.create(r), { filePath: e }), h = o(g);
+			if (h instanceof l) {
+				h.path = e, i.push(h);
+				continue;
+			} else o = h;
+		}
+		typeof o == "string" ? i.push(new y(e, o)) : i.push(new f(e), ...w(o, e, r));
+	}
+	return i;
+}, "flattenFileTree");
+n(async (s, t) => {
+	const r = t?.tempDir ? c.resolve(t.tempDir) : v, i = c.join(r, `${D}-${j()}/`);
+	if (await a.mkdir(i, { recursive: !0 }), s) {
+		if (typeof s == "string") await a.cp(s, i, {
+			recursive: !0,
+			filter: t?.templateFilter
+		});
+		else if (typeof s == "object") {
+			const p = {
+				fixturePath: i,
+				getPath: n((...e) => c.join(i, ...e), "getPath"),
+				symlink: n((e, o) => new l(e, o), "symlink")
+			};
+			await Promise.all(w(s, i, p).map(async (e) => {
+				e instanceof f ? await a.mkdir(e.path, { recursive: !0 }) : e instanceof l ? (await a.mkdir(c.dirname(e.path), { recursive: !0 }), await a.symlink(e.target, e.path, e.type)) : e instanceof y && (await a.mkdir(c.dirname(e.path), { recursive: !0 }), await a.writeFile(e.path, e.content));
+			}));
+		}
+	}
+	return new P(i);
+}, "createFixture");
+const nodeRequire = createRequire(import.meta.url);
+function resolveBinaryPath(packageName, binName) {
+	let packageJsonPath;
+	try {
+		packageJsonPath = nodeRequire.resolve(`${packageName}/package.json`);
+	} catch (error) {
+		throw new Error(`Unable to resolve ${packageName}. Install the package alongside @ccusage/mcp to enable ${packageName} tools.`, { cause: error });
+	}
+	const packageJson = nodeRequire(packageJsonPath);
+	const binField = packageJson.bin ?? packageJson.publishConfig?.bin;
+	let binRelative;
+	if (typeof binField === "string") binRelative = binField;
+	else if (binField != null && typeof binField === "object") binRelative = binName != null && binName !== "" ? binField[binName] : Object.values(binField)[0];
+	if (binRelative == null) throw new Error(`Unable to locate ${binName ?? packageName} binary entry in ${packageName}/package.json`);
+	const packageDir = c.dirname(packageJsonPath);
+	return c.resolve(packageDir, binRelative);
+}
+function createCliInvocation(entryPath) {
+	if (entryPath.endsWith(".ts")) return {
+		executable: "bun",
+		prefixArgs: [entryPath]
+	};
+	return {
+		executable: process$1.execPath,
+		prefixArgs: [entryPath]
+	};
+}
+async function executeCliCommand(executable, args, env) {
+	try {
+		const result = await spawn(executable, args, { env: {
+			...process$1.env,
+			FORCE_COLOR: "0",
+			...env
+		} });
+		const output = (result.stdout ?? result.output ?? "").trim();
+		if (output === "") throw new Error("CLI command returned empty output");
+		return output;
+	} catch (error) {
+		if (error instanceof SubprocessError) {
+			const message = (error.stderr ?? error.stdout ?? error.output ?? error.message).trim();
+			throw new Error(message);
+		}
+		throw error;
+	}
+}
+const filterDateSchema = z.string().regex(/^\d{8}$/, "Date must be in YYYYMMDD format");
+const ccusageParametersShape = {
+	since: filterDateSchema.optional(),
+	until: filterDateSchema.optional(),
+	mode: z.enum([
+		"auto",
+		"calculate",
+		"display"
+	]).default("auto").optional(),
+	timezone: z.string().optional(),
+	locale: z.string().optional()
+};
+const ccusageParametersSchema = z.object(ccusageParametersShape);
+let cachedCcusageInvocation = null;
+function getCcusageInvocation() {
+	if (cachedCcusageInvocation != null) return cachedCcusageInvocation;
+	const entryPath = resolveBinaryPath("ccusage", "ccusage");
+	cachedCcusageInvocation = createCliInvocation(entryPath);
+	return cachedCcusageInvocation;
+}
+async function runCcusageCliJson(command, parameters, claudePath) {
+	const { executable, prefixArgs } = getCcusageInvocation();
+	const cliArgs = [
+		...prefixArgs,
+		command,
+		"--json"
+	];
+	const since = parameters.since;
+	if (since != null && since !== "") cliArgs.push("--since", since);
+	const until = parameters.until;
+	if (until != null && until !== "") cliArgs.push("--until", until);
+	const mode = parameters.mode;
+	if (mode != null && mode !== "auto") cliArgs.push("--mode", mode);
+	const timezone = parameters.timezone;
+	if (timezone != null && timezone !== "") cliArgs.push("--timezone", timezone);
+	const locale = parameters.locale;
+	if (locale != null && locale !== "") cliArgs.push("--locale", locale);
+	return executeCliCommand(executable, cliArgs, { CLAUDE_CONFIG_DIR: claudePath });
+}
+async function getCcusageDaily(parameters, claudePath) {
+	try {
+		const raw = await runCcusageCliJson("daily", parameters, claudePath);
+		const parsed = JSON.parse(raw);
+		if (Array.isArray(parsed) && parsed.length === 0) return {
+			daily: [],
+			totals: {}
+		};
+		return parsed;
+	} catch {
+		return {
+			daily: [],
+			totals: {}
+		};
+	}
+}
+async function getCcusageMonthly(parameters, claudePath) {
+	try {
+		const raw = await runCcusageCliJson("monthly", parameters, claudePath);
+		const parsed = JSON.parse(raw);
+		if (Array.isArray(parsed) && parsed.length === 0) return {
+			monthly: [],
+			totals: {}
+		};
+		return parsed;
+	} catch {
+		return {
+			monthly: [],
+			totals: {}
+		};
+	}
+}
+async function getCcusageSession(parameters, claudePath) {
+	try {
+		const raw = await runCcusageCliJson("session", parameters, claudePath);
+		const parsed = JSON.parse(raw);
+		if (Array.isArray(parsed) && parsed.length === 0) return {
+			sessions: [],
+			totals: {}
+		};
+		return parsed;
+	} catch {
+		return {
+			sessions: [],
+			totals: {}
+		};
+	}
+}
+async function getCcusageBlocks(parameters, claudePath) {
+	try {
+		const raw = await runCcusageCliJson("blocks", parameters, claudePath);
+		const parsed = JSON.parse(raw);
+		if (Array.isArray(parsed) && parsed.length === 0) return { blocks: [] };
+		return parsed;
+	} catch {
+		return { blocks: [] };
+	}
+}
+const codexModelUsageSchema = z.object({
+	inputTokens: z.number(),
+	cachedInputTokens: z.number(),
+	outputTokens: z.number(),
+	reasoningOutputTokens: z.number(),
+	totalTokens: z.number(),
+	isFallback: z.boolean().optional()
+});
+const codexTotalsSchema = z.object({
+	inputTokens: z.number(),
+	cachedInputTokens: z.number(),
+	outputTokens: z.number(),
+	reasoningOutputTokens: z.number(),
+	totalTokens: z.number(),
+	costUSD: z.number()
+});
+const codexDailyRowSchema = z.object({
+	date: z.string(),
+	inputTokens: z.number(),
+	cachedInputTokens: z.number(),
+	outputTokens: z.number(),
+	reasoningOutputTokens: z.number(),
+	totalTokens: z.number(),
+	costUSD: z.number(),
+	models: z.record(codexModelUsageSchema)
+});
+const codexMonthlyRowSchema = z.object({
+	month: z.string(),
+	inputTokens: z.number(),
+	cachedInputTokens: z.number(),
+	outputTokens: z.number(),
+	reasoningOutputTokens: z.number(),
+	totalTokens: z.number(),
+	costUSD: z.number(),
+	models: z.record(codexModelUsageSchema)
+});
+const codexDailyResponseSchema = z.object({
+	daily: z.array(codexDailyRowSchema),
+	totals: codexTotalsSchema.nullable()
+});
+const codexMonthlyResponseSchema = z.object({
+	monthly: z.array(codexMonthlyRowSchema),
+	totals: codexTotalsSchema.nullable()
+});
+const codexParametersShape = {
+	since: z.string().optional(),
+	until: z.string().optional(),
+	timezone: z.string().optional(),
+	locale: z.string().optional(),
+	offline: z.boolean().optional()
+};
+const codexParametersSchema = z.object(codexParametersShape);
+let cachedCodexInvocation = null;
+function getCodexInvocation() {
+	if (cachedCodexInvocation != null) return cachedCodexInvocation;
+	const entryPath = resolveBinaryPath("@ccusage/codex", "ccusage-codex");
+	cachedCodexInvocation = createCliInvocation(entryPath);
+	return cachedCodexInvocation;
+}
+async function runCodexCliJson(command, parameters) {
+	const { executable, prefixArgs } = getCodexInvocation();
+	const cliArgs = [
+		...prefixArgs,
+		command,
+		"--json"
+	];
+	const since = parameters.since;
+	if (since != null && since !== "") cliArgs.push("--since", since);
+	const until = parameters.until;
+	if (until != null && until !== "") cliArgs.push("--until", until);
+	const timezone = parameters.timezone;
+	if (timezone != null && timezone !== "") cliArgs.push("--timezone", timezone);
+	const locale = parameters.locale;
+	if (locale != null && locale !== "") cliArgs.push("--locale", locale);
+	if (parameters.offline === true) cliArgs.push("--offline");
+	else if (parameters.offline === false) cliArgs.push("--no-offline");
+	return executeCliCommand(executable, cliArgs, {});
+}
+async function getCodexDaily(parameters) {
+	const raw = await runCodexCliJson("daily", parameters);
+	return codexDailyResponseSchema.parse(JSON.parse(raw));
+}
+async function getCodexMonthly(parameters) {
+	const raw = await runCodexCliJson("monthly", parameters);
+	return codexMonthlyResponseSchema.parse(JSON.parse(raw));
+}
+function defaultOptions() {
+	const paths = getClaudePaths();
+	if (paths.length === 0) throw new Error("No valid Claude path found. Ensure getClaudePaths() returns at least one valid path.");
+	return { claudePath: paths[0] };
+}
+function createMcpServer(options) {
+	const server = new McpServer({
+		name,
+		version
+	});
+	const { claudePath = "" } = options ?? defaultOptions();
+	if (claudePath === "") throw new Error("Claude path is required");
+	server.registerTool("daily", {
+		description: "Show usage report grouped by date",
+		inputSchema: ccusageParametersShape
+	}, async (args) => {
+		const parameters = ccusageParametersSchema.parse(args);
+		const jsonOutput = await getCcusageDaily(parameters, claudePath);
+		return { content: [{
+			type: "text",
+			text: JSON.stringify(jsonOutput, null, 2)
+		}] };
+	});
+	server.registerTool("session", {
+		description: "Show usage report grouped by conversation session",
+		inputSchema: ccusageParametersShape
+	}, async (args) => {
+		const parameters = ccusageParametersSchema.parse(args);
+		const jsonOutput = await getCcusageSession(parameters, claudePath);
+		return { content: [{
+			type: "text",
+			text: JSON.stringify(jsonOutput, null, 2)
+		}] };
+	});
+	server.registerTool("monthly", {
+		description: "Show usage report grouped by month",
+		inputSchema: ccusageParametersShape
+	}, async (args) => {
+		const parameters = ccusageParametersSchema.parse(args);
+		const jsonOutput = await getCcusageMonthly(parameters, claudePath);
+		return { content: [{
+			type: "text",
+			text: JSON.stringify(jsonOutput, null, 2)
+		}] };
+	});
+	server.registerTool("blocks", {
+		description: "Show usage report grouped by session billing blocks",
+		inputSchema: ccusageParametersShape
+	}, async (args) => {
+		const parameters = ccusageParametersSchema.parse(args);
+		const jsonOutput = await getCcusageBlocks(parameters, claudePath);
+		return { content: [{
+			type: "text",
+			text: JSON.stringify(jsonOutput, null, 2)
+		}] };
+	});
+	server.registerTool("codex-daily", {
+		description: "Show Codex usage grouped by day",
+		inputSchema: codexParametersShape
+	}, async (args) => {
+		const parameters = codexParametersSchema.parse(args);
+		const codexDaily = await getCodexDaily(parameters);
+		return { content: [{
+			type: "text",
+			text: JSON.stringify(codexDaily, null, 2)
+		}] };
+	});
+	server.registerTool("codex-monthly", {
+		description: "Show Codex usage grouped by month",
+		inputSchema: codexParametersShape
+	}, async (args) => {
+		const parameters = codexParametersSchema.parse(args);
+		const codexMonthly = await getCodexMonthly(parameters);
+		return { content: [{
+			type: "text",
+			text: JSON.stringify(codexMonthly, null, 2)
+		}] };
+	});
+	return server;
+}
+async function startMcpServerStdio(server) {
+	const transport = new StdioServerTransport();
+	await server.connect(transport);
+}
+function createMcpHttpApp(options) {
+	const app = new Hono();
+	const mcpServer = createMcpServer(options ?? defaultOptions());
+	app.all("/", async (c$1) => {
+		const transport = new StreamableHTTPTransport();
+		await mcpServer.connect(transport);
+		return transport.handleRequest(c$1);
+	});
+	return app;
+}
+const MCP_DEFAULT_PORT = 8080;
+const mcpCommand = define({
+	name: "mcp",
+	description: "Start MCP server with usage reporting tools",
+	args: {
+		mode: {
+			type: "enum",
+			short: "m",
+			description: "Cost calculation mode for usage reports",
+			choices: [
+				"auto",
+				"calculate",
+				"display"
+			],
+			default: "auto"
+		},
+		type: {
+			type: "enum",
+			short: "t",
+			description: "Transport type for MCP server",
+			choices: ["stdio", "http"],
+			default: "stdio"
+		},
+		port: {
+			type: "number",
+			short: "p",
+			description: `Port for HTTP transport (default: ${MCP_DEFAULT_PORT})`,
+			default: MCP_DEFAULT_PORT
+		}
+	},
+	async run(ctx) {
+		const { type: mcpType, mode, port } = ctx.values;
+		if (mcpType === "stdio") logger.level = 0;
+		const paths = getClaudePaths();
+		if (paths.length === 0) {
+			logger.error("No valid Claude data directory found");
+			throw new Error("No valid Claude data directory found");
+		}
+		const options = {
+			claudePath: paths.at(0),
+			mode
+		};
+		switch (mcpType) {
+			case "stdio": {
+				const server = createMcpServer(options);
+				await startMcpServerStdio(server);
+				return;
+			}
+			case "http": {
+				const app = createMcpHttpApp(options);
+				serve({
+					fetch: app.fetch,
+					port
+				});
+				logger.info(`MCP server is running on http://localhost:${port}`);
+				return;
+			}
+			default: throw new Error(`Unsupported MCP type: ${mcpType}`);
+		}
+	}
+});
+async function runCli(argv = process$1.argv.slice(2)) {
+	await cli(argv, mcpCommand, {
+		name,
+		version,
+		description,
+		subCommands: /* @__PURE__ */ new Map()
+	});
+}
+runCli();
+export {};

package/package.json

@@ -1,12 +1,44 @@
 {
   "name": "@ccusage/mcp",
-  "version": "0.0.1",
-  "module": "index.ts",
+  "version": "17.0.0",
+  "description": "MCP server implementation for ccusage data",
+  "homepage": "https://github.com/ryoppippi/ccusage#readme",
+  "bugs": {
+    "url": "https://github.com/ryoppippi/ccusage/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ryoppippi/ccusage.git"
+  },
+  "funding": "https://github.com/ryoppippi/ccusage?sponsor=1",
+  "license": "MIT",
+  "author": "ryoppippi",
   "type": "module",
-  "devDependencies": {
-    "@types/bun": "latest"
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "ccusage-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@hono/mcp": "^0.1.4",
+    "@hono/node-server": "^1.19.2",
+    "@modelcontextprotocol/sdk": "^1.17.3",
+    "gunshi": "^0.26.3",
+    "hono": "^4.9.2",
+    "nano-spawn": "^1.0.2",
+    "zod": "^3.25.67",
+    "ccusage": "17.0.0",
+    "@ccusage/codex": "17.0.0"
   },
-  "peerDependencies": {
-    "typescript": "^5"
+  "engines": {
+    "node": ">=20.19.4"
   }
-}
+}

package/CLAUDE.md

@@ -1,107 +0,0 @@
----
-
-Default to using Bun instead of Node.js.
-
-- Use `bun <file>` instead of `node <file>` or `ts-node <file>`
-- Use `bun test` instead of `jest` or `vitest`
-- Use `bun build <file.html|file.ts|file.css>` instead of `webpack` or `esbuild`
-- Use `bun install` instead of `npm install` or `yarn install` or `pnpm install`
-- Use `bun run <script>` instead of `npm run <script>` or `yarn run <script>` or `pnpm run <script>`
-- Bun automatically loads .env, so don't use dotenv.
-
-## APIs
-
-- `Bun.serve()` supports WebSockets, HTTPS, and routes. Don't use `express`.
-- `bun:sqlite` for SQLite. Don't use `better-sqlite3`.
-- `Bun.redis` for Redis. Don't use `ioredis`.
-- `Bun.sql` for Postgres. Don't use `pg` or `postgres.js`.
-- `WebSocket` is built-in. Don't use `ws`.
-- Prefer `Bun.file` over `node:fs`'s readFile/writeFile
-- Bun.$`ls` instead of execa.
-
-## Testing
-
-Use `bun test` to run tests.
-
-```ts#index.test.ts
-import { test, expect } from "bun:test";
-
-test("hello world", () => {
-  expect(1).toBe(1);
-});
-```
-
-## Frontend
-
-Use HTML imports with `Bun.serve()`. Don't use `vite`. HTML imports fully support React, CSS, Tailwind.
-
-Server:
-
-```ts#index.ts
-import index from "./index.html"
-
-Bun.serve({
-  routes: {
-    "/": index,
-    "/api/users/:id": {
-      GET: (req) => {
-        return new Response(JSON.stringify({ id: req.params.id }));
-      },
-    },
-  },
-  // optional websocket support
-  websocket: {
-    open: (ws) => {
-      ws.send("Hello, world!");
-    },
-    message: (ws, message) => {
-      ws.send(message);
-    },
-    close: (ws) => {
-      // handle close
-    }
-  },
-  development: {
-    hmr: true,
-    console: true,
-  }
-})
-```
-
-HTML files can import .tsx, .jsx or .js files directly and Bun's bundler will transpile & bundle automatically. `<link>` tags can point to stylesheets and Bun's CSS bundler will bundle.
-
-```html#index.html
-<html>
-  <body>
-    <h1>Hello, world!</h1>
-    <script type="module" src="./frontend.tsx"></script>
-  </body>
-</html>
-```
-
-With the following `frontend.tsx`:
-
-```tsx#frontend.tsx
-import React from "react";
-
-// import .css files directly and it works
-import './index.css';
-
-import { createRoot } from "react-dom/client";
-
-const root = createRoot(document.body);
-
-export default function Frontend() {
-  return <h1>Hello, world!</h1>;
-}
-
-root.render(<Frontend />);
-```
-
-Then, run index.ts
-
-```sh
-bun --hot ./index.ts
-```
-
-For more information, read the Bun API docs in `node_modules/bun-types/docs/**.md`.

package/bun.lock

@@ -1,29 +0,0 @@
-{
-  "lockfileVersion": 1,
-  "workspaces": {
-    "": {
-      "name": "mk",
-      "devDependencies": {
-        "@types/bun": "latest",
-      },
-      "peerDependencies": {
-        "typescript": "^5",
-      },
-    },
-  },
-  "packages": {
-    "@types/bun": ["@types/bun@1.2.20", "", { "dependencies": { "bun-types": "1.2.20" } }, "sha512-dX3RGzQ8+KgmMw7CsW4xT5ITBSCrSbfHc36SNT31EOUg/LA9JWq0VDdEXDRSe1InVWpd2yLUM1FUF/kEOyTzYA=="],
-
-    "@types/node": ["@types/node@24.3.0", "", { "dependencies": { "undici-types": "~7.10.0" } }, "sha512-aPTXCrfwnDLj4VvXrm+UUCQjNEvJgNA8s5F1cvwQU+3KNltTOkBm1j30uNLyqqPNe7gE3KFzImYoZEfLhp4Yow=="],
-
-    "@types/react": ["@types/react@19.1.10", "", { "dependencies": { "csstype": "^3.0.2" } }, "sha512-EhBeSYX0Y6ye8pNebpKrwFJq7BoQ8J5SO6NlvNwwHjSj6adXJViPQrKlsyPw7hLBLvckEMO1yxeGdR82YBBlDg=="],
-
-    "bun-types": ["bun-types@1.2.20", "", { "dependencies": { "@types/node": "*" }, "peerDependencies": { "@types/react": "^19" } }, "sha512-pxTnQYOrKvdOwyiyd/7sMt9yFOenN004Y6O4lCcCUoKVej48FS5cvTw9geRaEcB9TsDZaJKAxPTVvi8tFsVuXA=="],
-
-    "csstype": ["csstype@3.1.3", "", {}, "sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw=="],
-
-    "typescript": ["typescript@5.9.2", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-CWBzXQrc/qOkhidw1OzBTQuYRbfyxDXJMVJ1XNwUHGROVmuaeiEm3OslpZ1RV96d7SKKjZKrSJu3+t/xlw3R9A=="],
-
-    "undici-types": ["undici-types@7.10.0", "", {}, "sha512-t5Fy/nfn+14LuOc2KNYg75vZqClpAiqscVvMygNnlsHBFpSXdJaYtXMcdNLpl/Qvc3P2cB3s6lOV51nqsFq4ag=="],
-  }
-}

package/index.ts

@@ -1 +0,0 @@
-console.log("hello ccusage");

package/tsconfig.json

@@ -1,29 +0,0 @@
-{
-  "compilerOptions": {
-    // Environment setup & latest features
-    "lib": ["ESNext"],
-    "target": "ESNext",
-    "module": "Preserve",
-    "moduleDetection": "force",
-    "jsx": "react-jsx",
-    "allowJs": true,
-
-    // Bundler mode
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": true,
-    "noEmit": true,
-
-    // Best practices
-    "strict": true,
-    "skipLibCheck": true,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedIndexedAccess": true,
-    "noImplicitOverride": true,
-
-    // Some stricter flags (disabled by default)
-    "noUnusedLocals": false,
-    "noUnusedParameters": false,
-    "noPropertyAccessFromIndexSignature": false
-  }
-}