@363045841yyt/klinechart-ai-runtime 0.1.0

package/README.md

@@ -0,0 +1,130 @@
+# @363045841yyt/klinechart-ai-runtime
+
+MCP (Model Context Protocol) server and AI tool schemas for
+[@363045841yyt/klinechart-core](https://github.com/363045841/KLineChartQuant/tree/main/packages/core)
+([npm](https://www.npmjs.com/package/@363045841yyt/klinechart-core))
+/
+[@363045841yyt/klinechart](https://github.com/363045841/KLineChartQuant/tree/main/packages/vue)
+([npm](https://www.npmjs.com/package/@363045841yyt/klinechart)).
+
+Optional addon — install only if you need AI agent / MCP control of your charts.
+
+Provides a WebSocket-bridged MCP server that enables AI agents (via MCP Inspector
+or any MCP client) to control K-line chart operations — zoom, pan, add/remove
+indicators, change theme, and more.
+
+## Installation
+
+```bash
+pnpm add @363045841yyt/klinechart-ai-runtime
+```
+
+Requires `@363045841yyt/klinechart-core` as a peer dependency.
+
+## Quick Start
+
+### Start the MCP server
+
+```ts
+import { createMcpServer } from '@363045841yyt/klinechart-ai-runtime/mcp-server'
+
+const { start, stop } = createMcpServer({
+  ws: { port: 8080 },
+})
+
+await start()
+```
+
+### Integrate with KLineChart (Vue example)
+
+```vue
+<script setup lang="ts">
+import KLineChart from '@363045841yyt/klinechart'
+import { executeTool } from '@363045841yyt/klinechart-ai-runtime'
+
+const chartRef = ref<InstanceType<typeof KLineChart> | null>(null)
+
+const mcpConfig = {
+  wsUrl: 'ws://localhost:8080',
+  autoReconnect: true,
+  onToolCall: (call) => {
+    const ctrl = chartRef.value?.getController?.()
+    if (!ctrl) return { success: false, error: 'Controller not ready' }
+    return executeTool(ctrl, call)
+  },
+}
+</script>
+
+<template>
+  <KLineChart ref="chartRef" :mcp="mcpConfig" />
+</template>
+```
+
+### Connect from MCP Inspector
+
+```bash
+cd packages/ai-runtime
+pnpm inspect
+```
+
+Then call tools like `chart.zoomToLevel` with `{ "level": 5 }`.
+
+## Exports
+
+### Main entry (`@363045841yyt/klinechart-ai-runtime`)
+
+| Export | Description |
+|--------|-------------|
+| `executeTool` | Dispatch a tool call to a chart controller |
+| `ALL_TOOLS` | Array of all supported tool schemas |
+| `TOOL_GROUPS` | Grouped tool definitions |
+| `findTool(name)` | Look up a tool schema by name |
+| `describeVolumeProfileState` | Generate VP state summary |
+| `describeAnchoredVwap` | Generate anchored VWAP summary |
+| `describeFootprintLatestBar` | Generate footprint summary |
+| `describeAlerts` | Generate alerts summary |
+| `serialize` / `deserialize` | Chart state serialization |
+| `SessionRegistry` | WebSocket session manager |
+
+### MCP Server (`@363045841yyt/klinechart-ai-runtime/mcp-server`)
+
+| Export | Description |
+|--------|-------------|
+| `createMcpServer(options)` | Create MCP + WebSocket server instance |
+
+### Create with MCP (`@363045841yyt/klinechart-ai-runtime/create-with-mcp`)
+
+Legacy helper — prefer `executeTool` + `mcp` prop pattern above.
+
+## Architecture
+
+```
+┌─────────────────┐        WebSocket          ┌───────────────────┐
+│   Browser       │◄─────────────────────────►│  MCP Server       │
+│                 │   register / tool:call    │  (Node.js)        │
+│  KLineChart     │   tool:result /           │                   │
+│  └─ ChartBridge │   state:update            │ ┌─ SessionRegistry│
+│       ↓         │                           │ └─ WsSessionHandle│
+│  └─ onToolCall ─┼───────────────────────────┼──► executeTool    │
+└─────────────────┘                           └────────┬──────────┘
+                                                       │ stdio
+                                                       ▼
+                                               ┌────────────────────┐
+                                               │  MCP Client        │
+                                               │  (Inspector / AI)  │
+                                               └────────────────────┘
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `chart.zoomToLevel` | Zoom to a specific level |
+| `chart.setTheme` | Switch between light/dark theme |
+| `indicators.add` | Add an indicator by definition ID |
+| `indicators.remove` | Remove an indicator by instance ID |
+| `indicators.updateParams` | Update indicator parameters |
+
+## License
+
+MIT

package/dist/createWithMcp.d.ts

@@ -0,0 +1,9 @@
+import { type ChartMountOptions, type ChartController } from '@363045841yyt/klinechart-core';
+export interface CreateChartWithMcpOptions extends ChartMountOptions {
+    mcp: {
+        wsUrl?: string;
+        autoReconnect?: boolean;
+    };
+}
+export declare function createChartControllerWithMcp(opts: CreateChartWithMcpOptions): ChartController;
+//# sourceMappingURL=createWithMcp.d.ts.map

package/dist/createWithMcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createWithMcp.d.ts","sourceRoot":"","sources":["../src/createWithMcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAA;AAGtC,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAClE,GAAG,EAAE;QACH,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,aAAa,CAAC,EAAE,OAAO,CAAA;KACxB,CAAA;CACF;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,yBAAyB,GAC9B,eAAe,CAWjB"}

package/dist/createWithMcp.js

@@ -0,0 +1,15 @@
+import { createChartController, } from '@363045841yyt/klinechart-core';
+import { executeTool } from './executeTool';
+export function createChartControllerWithMcp(opts) {
+    let ctrl;
+    ctrl = createChartController({
+        ...opts,
+        mcp: {
+            wsUrl: opts.mcp.wsUrl,
+            autoReconnect: opts.mcp.autoReconnect,
+            onToolCall: (call) => executeTool(ctrl, call),
+        },
+    });
+    return ctrl;
+}
+//# sourceMappingURL=createWithMcp.js.map

package/dist/createWithMcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createWithMcp.js","sourceRoot":"","sources":["../src/createWithMcp.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,GAGtB,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAS3C,MAAM,UAAU,4BAA4B,CAC1C,IAA+B;IAE/B,IAAI,IAAqB,CAAA;IACzB,IAAI,GAAG,qBAAqB,CAAC;QAC3B,GAAG,IAAI;QACP,GAAG,EAAE;YACH,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK;YACrB,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa;YACrC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC;SAC9C;KACF,CAAC,CAAA;IACF,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/describeControllers.d.ts

@@ -0,0 +1,34 @@
+import type { ControllerDescription } from './types';
+export interface VolumeProfileSnapshot {
+    poc: number;
+    vah: number;
+    val: number;
+    totalVolume: number;
+    vaVolume: number;
+}
+export declare function describeVolumeProfileState(state: VolumeProfileSnapshot | null): ControllerDescription;
+export interface AnchoredVwapSeriesSnapshot {
+    label: string;
+    barIndex: number;
+    vwap: number;
+    upper1: number;
+    lower1: number;
+    upper2: number;
+    lower2: number;
+}
+export declare function describeAnchoredVwap(activeAnchors: ReadonlyArray<AnchoredVwapSeriesSnapshot>, latestPrice: number | null): ControllerDescription;
+export interface FootprintLatestBarSnapshot {
+    barIndex: number;
+    delta: number;
+    totalVolume: number;
+    imbalanceCount: number;
+    maxImbalanceRatio: number;
+}
+export declare function describeFootprintLatestBar(bar: FootprintLatestBarSnapshot | null, cumulativeDelta: number): ControllerDescription;
+export interface AlertSnapshot {
+    rulesEnabled: number;
+    rulesTotal: number;
+    recentEventsCount: number;
+}
+export declare function describeAlerts(state: AlertSnapshot): ControllerDescription;
+//# sourceMappingURL=describeControllers.d.ts.map

package/dist/describeControllers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describeControllers.d.ts","sourceRoot":"","sources":["../src/describeControllers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAEpD,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,qBAAqB,GAAG,IAAI,GAClC,qBAAqB,CA8BvB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,aAAa,CAAC,0BAA0B,CAAC,EACxD,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,qBAAqB,CAmCvB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,0BAA0B,GAAG,IAAI,EACtC,eAAe,EAAE,MAAM,GACtB,qBAAqB,CAsCvB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,qBAAqB,CAc1E"}

package/dist/describeControllers.js

@@ -0,0 +1,104 @@
+export function describeVolumeProfileState(state) {
+    if (state === null) {
+        return {
+            controllerId: 'volumeProfile',
+            summary: 'Volume Profile has not been computed yet — no bars have been ingested.',
+            facts: { ready: false },
+        };
+    }
+    const vaPercent = state.totalVolume > 0 ? (state.vaVolume / state.totalVolume) * 100 : 0;
+    const vaSpan = state.vah - state.val;
+    return {
+        controllerId: 'volumeProfile',
+        summary: `Volume Profile shows the Point of Control at ${state.poc.toFixed(2)} — ` +
+            `the price level with the highest traded volume. The Value Area runs from ` +
+            `${state.val.toFixed(2)} (VAL) to ${state.vah.toFixed(2)} (VAH), spanning ` +
+            `${vaSpan.toFixed(2)} and containing ${vaPercent.toFixed(1)}% of total volume.`,
+        facts: {
+            poc: state.poc,
+            vah: state.vah,
+            val: state.val,
+            vaSpan: Number(vaSpan.toFixed(8)),
+            vaPercent: Number(vaPercent.toFixed(2)),
+            totalVolume: state.totalVolume,
+        },
+    };
+}
+export function describeAnchoredVwap(activeAnchors, latestPrice) {
+    if (activeAnchors.length === 0) {
+        return {
+            controllerId: 'anchoredVwap',
+            summary: 'No Anchored VWAP series are active.',
+            facts: { count: 0 },
+        };
+    }
+    const lines = [];
+    for (const a of activeAnchors) {
+        const rel = latestPrice === null
+            ? ''
+            : latestPrice > a.upper1
+                ? ' (price above 1\u03c3 upper band \u2014 overextended)'
+                : latestPrice < a.lower1
+                    ? ' (price below 1\u03c3 lower band \u2014 overextended)'
+                    : '';
+        lines.push(`"${a.label}" at ${a.vwap.toFixed(2)}, \u00b11\u03c3 [${a.lower1.toFixed(2)}, ${a.upper1.toFixed(2)}]${rel}`);
+    }
+    return {
+        controllerId: 'anchoredVwap',
+        summary: `${activeAnchors.length} Anchored VWAP series active. ` +
+            lines.join('; ') +
+            '.',
+        facts: {
+            count: activeAnchors.length,
+            anchors: lines.join(' | '),
+        },
+    };
+}
+export function describeFootprintLatestBar(bar, cumulativeDelta) {
+    if (bar === null) {
+        return {
+            controllerId: 'footprint',
+            summary: 'Footprint controller has no bars yet.',
+            facts: { ready: false },
+        };
+    }
+    const tone = bar.delta > 0
+        ? 'buy-dominated'
+        : bar.delta < 0
+            ? 'sell-dominated'
+            : 'balanced';
+    const imbalance = bar.imbalanceCount > 0
+        ? `${bar.imbalanceCount} diagonal imbalance${bar.imbalanceCount === 1 ? '' : 's'} ` +
+            `(max ratio ${bar.maxImbalanceRatio.toFixed(1)}\u00d7)`
+        : 'no imbalances flagged';
+    return {
+        controllerId: 'footprint',
+        summary: `Latest footprint bar #${bar.barIndex} is ${tone} with delta ${bar.delta.toFixed(0)} ` +
+            `against ${bar.totalVolume.toFixed(0)} total volume. ${imbalance}. ` +
+            `Cumulative delta across visible bars: ${cumulativeDelta.toFixed(0)}.`,
+        facts: {
+            barIndex: bar.barIndex,
+            delta: bar.delta,
+            tone,
+            totalVolume: bar.totalVolume,
+            imbalanceCount: bar.imbalanceCount,
+            maxImbalanceRatio: Number(bar.maxImbalanceRatio.toFixed(2)),
+            cumulativeDelta,
+        },
+    };
+}
+export function describeAlerts(state) {
+    return {
+        controllerId: 'alerts',
+        summary: state.rulesTotal === 0
+            ? 'No alert rules configured.'
+            : `${state.rulesEnabled} of ${state.rulesTotal} alert rules are enabled. ` +
+                `${state.recentEventsCount} recent events buffered.`,
+        facts: {
+            rulesEnabled: state.rulesEnabled,
+            rulesTotal: state.rulesTotal,
+            recentEventsCount: state.recentEventsCount,
+        },
+    };
+}
+//# sourceMappingURL=describeControllers.js.map

package/dist/describeControllers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describeControllers.js","sourceRoot":"","sources":["../src/describeControllers.ts"],"names":[],"mappings":"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"}

package/dist/executeTool.d.ts

@@ -0,0 +1,12 @@
+import type { ChartController } from '@363045841yyt/klinechart-core';
+export interface ToolCall {
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface ToolResult {
+    success: boolean;
+    error?: string;
+    data?: unknown;
+}
+export declare function executeTool(chart: ChartController, call: ToolCall): ToolResult;
+//# sourceMappingURL=executeTool.d.ts.map

package/dist/executeTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeTool.d.ts","sourceRoot":"","sources":["../src/executeTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAGpE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,QAAQ,GACb,UAAU,CA0EZ"}

package/dist/executeTool.js

@@ -0,0 +1,63 @@
+import { findTool } from './toolSchemas';
+export function executeTool(chart, call) {
+    const schema = findTool(call.name);
+    if (!schema) {
+        return { success: false, error: `Unknown tool: ${call.name}` };
+    }
+    switch (call.name) {
+        case 'chart.zoomToLevel': {
+            const { level, anchorX } = call.input;
+            chart.zoomToLevel(level, anchorX);
+            return { success: true };
+        }
+        case 'chart.setTheme': {
+            const { theme } = call.input;
+            chart.setTheme(theme);
+            return { success: true };
+        }
+        case 'indicators.add': {
+            const { definitionId } = call.input;
+            const def = chart.catalog.find((d) => d.id === definitionId);
+            const role = def?.role ?? 'main';
+            const instanceId = chart.addIndicator(definitionId, role);
+            return { success: true, data: { instanceId } };
+        }
+        case 'indicators.remove': {
+            const { instanceId } = call.input;
+            const ok = chart.removeIndicator(instanceId);
+            return ok
+                ? { success: true }
+                : { success: false, error: `Indicator ${instanceId} not found` };
+        }
+        case 'indicators.updateParams': {
+            const { instanceId, params } = call.input;
+            const ok = chart.updateIndicatorParams(instanceId, params);
+            return ok
+                ? { success: true }
+                : { success: false, error: `Indicator ${instanceId} not found` };
+        }
+        // Alerts controller does not exist on main yet — placeholder
+        case 'alerts.addPriceCross':
+        case 'alerts.addIndicatorCross':
+        case 'alerts.remove': {
+            return {
+                success: false,
+                error: `"${call.name}" is not implemented — alerts controller is not available`,
+            };
+        }
+        // Replay controller does not exist on main yet — placeholder
+        case 'replay.seekTo':
+        case 'replay.play':
+        case 'replay.pause':
+        case 'replay.setSpeed': {
+            return {
+                success: false,
+                error: `"${call.name}" is not implemented — replay controller is not available`,
+            };
+        }
+        default: {
+            return { success: false, error: `No handler registered for ${call.name}` };
+        }
+    }
+}
+//# sourceMappingURL=executeTool.js.map

package/dist/executeTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeTool.js","sourceRoot":"","sources":["../src/executeTool.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export type * from './types';
+export { ALL_TOOLS, TOOL_GROUPS, CHART_NAVIGATION_TOOLS, INDICATOR_TOOLS, ALERT_TOOLS, REPLAY_TOOLS, findTool, } from './toolSchemas';
+export { describeVolumeProfileState, describeAnchoredVwap, describeFootprintLatestBar, describeAlerts, type VolumeProfileSnapshot, type AnchoredVwapSeriesSnapshot, type FootprintLatestBarSnapshot, type AlertSnapshot, } from './describeControllers';
+export { serialize, deserialize, ChartSerializationError, type ChartSnapshotInput, } from './serialization';
+export { executeTool, type ToolCall, type ToolResult } from './executeTool';
+export { SessionRegistry, type SessionHandle } from './sessionRegistry';
+export { createChartControllerWithMcp, type CreateChartWithMcpOptions, } from './createWithMcp';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,SAAS,CAAA;AAE5B,OAAO,EACL,SAAS,EACT,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,QAAQ,GACT,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,0BAA0B,EAC1B,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,aAAa,GACnB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EACL,SAAS,EACT,WAAW,EACX,uBAAuB,EACvB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,WAAW,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAA;AAE3E,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEvE,OAAO,EACL,4BAA4B,EAC5B,KAAK,yBAAyB,GAC/B,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { ALL_TOOLS, TOOL_GROUPS, CHART_NAVIGATION_TOOLS, INDICATOR_TOOLS, ALERT_TOOLS, REPLAY_TOOLS, findTool, } from './toolSchemas';
+export { describeVolumeProfileState, describeAnchoredVwap, describeFootprintLatestBar, describeAlerts, } from './describeControllers';
+export { serialize, deserialize, ChartSerializationError, } from './serialization';
+export { executeTool } from './executeTool';
+export { SessionRegistry } from './sessionRegistry';
+export { createChartControllerWithMcp, } from './createWithMcp';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,SAAS,EACT,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,QAAQ,GACT,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,0BAA0B,EAC1B,cAAc,GAKf,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EACL,SAAS,EACT,WAAW,EACX,uBAAuB,GAExB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,WAAW,EAAkC,MAAM,eAAe,CAAA;AAE3E,OAAO,EAAE,eAAe,EAAsB,MAAM,mBAAmB,CAAA;AAEvE,OAAO,EACL,4BAA4B,GAE7B,MAAM,iBAAiB,CAAA"}

package/dist/mcpServer.d.ts

@@ -0,0 +1,35 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { WebSocketServer, type WebSocket } from 'ws';
+import type { ToolCall, ToolResult } from './executeTool';
+import { SessionRegistry, type SessionHandle } from './sessionRegistry';
+declare class WsSessionHandle implements SessionHandle {
+    readonly sessionId: string;
+    private ws;
+    private pending;
+    private msgSeq;
+    constructor(sessionId: string, ws: WebSocket);
+    executeTool(call: ToolCall): Promise<ToolResult>;
+    handleMessage(msg: Record<string, unknown>): void;
+    isAlive(): boolean;
+}
+export type { WsSessionHandle };
+export interface McpServerOptions {
+    serverInfo?: {
+        name?: string;
+        version?: string;
+    };
+    ws?: {
+        port?: number;
+        host?: string;
+    };
+    registry?: SessionRegistry;
+}
+export interface McpServerInstance {
+    server: Server;
+    registry: SessionRegistry;
+    wss: WebSocketServer;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+export declare function createMcpServer(options?: McpServerOptions): McpServerInstance;
+//# sourceMappingURL=mcpServer.d.ts.map

package/dist/mcpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpServer.d.ts","sourceRoot":"","sources":["../src/mcpServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAMlE,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,IAAI,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAGzD,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEvE,cAAM,eAAgB,YAAW,aAAa;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,OAAO,CAAC,EAAE,CAAW;IACrB,OAAO,CAAC,OAAO,CAGZ;IACH,OAAO,CAAC,MAAM,CAAI;gBAGhB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,SAAS;IAMT,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IA0BtD,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAWjD,OAAO,IAAI,OAAO;CAGnB;AAED,YAAY,EAAE,eAAe,EAAE,CAAA;AAO/B,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAChD,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACrC,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,eAAe,CAAA;IACzB,GAAG,EAAE,eAAe,CAAA;IACpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,iBAAiB,CA+KjF"}

package/dist/mcpServer.js

@@ -0,0 +1,189 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ListToolsRequestSchema, CallToolRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { WebSocketServer } from 'ws';
+import { ALL_TOOLS } from './toolSchemas';
+import { SessionRegistry } from './sessionRegistry';
+class WsSessionHandle {
+    sessionId;
+    ws;
+    pending = new Map();
+    msgSeq = 0;
+    constructor(sessionId, ws) {
+        this.sessionId = sessionId;
+        this.ws = ws;
+    }
+    async executeTool(call) {
+        const requestId = `${this.sessionId}:${++this.msgSeq}`;
+        return new Promise((resolve, reject) => {
+            this.pending.set(requestId, { resolve, reject });
+            if (this.ws.readyState !== this.ws.OPEN) {
+                this.pending.delete(requestId);
+                reject(new Error('WebSocket is not open'));
+                return;
+            }
+            this.ws.send(JSON.stringify({ type: 'tool:call', requestId, call }));
+            setTimeout(() => {
+                const p = this.pending.get(requestId);
+                if (p) {
+                    this.pending.delete(requestId);
+                    reject(new Error(`Tool call timed out: ${call.name}`));
+                }
+            }, 30_000);
+        });
+    }
+    handleMessage(msg) {
+        if (msg.type === 'tool:result') {
+            const requestId = msg.requestId;
+            const pending = this.pending.get(requestId);
+            if (pending) {
+                this.pending.delete(requestId);
+                pending.resolve(msg.result);
+            }
+        }
+    }
+    isAlive() {
+        return this.ws.readyState === this.ws.OPEN;
+    }
+}
+export function createMcpServer(options = {}) {
+    const registry = options.registry ?? new SessionRegistry();
+    const wsPort = options.ws?.port ?? 8080;
+    const wsHost = options.ws?.host ?? '0.0.0.0';
+    const serverInfoName = options.serverInfo?.name ?? 'klinechart-ai-mcp';
+    const serverInfoVersion = options.serverInfo?.version ?? '0.0.0';
+    const server = new Server({
+        name: serverInfoName,
+        version: serverInfoVersion,
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: ALL_TOOLS.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const schema = ALL_TOOLS.find((t) => t.name === name);
+        if (!schema) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: `Unknown tool: ${name}`,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const sessions = registry.getActiveSessionIds();
+        if (sessions.length === 0) {
+            console.warn(`[MCP] CallTool "${name}" but no sessions registered`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: 'No browser chart session connected.',
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const sessionId = sessions[0];
+        const handle = registry.get(sessionId);
+        if (!handle) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: `Session ${sessionId} not found.`,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const result = await handle.executeTool({
+            name,
+            input: args ?? {},
+        });
+        const summary = registry.getSummary(sessionId);
+        const texts = [JSON.stringify(result)];
+        if (summary)
+            texts.push(`Chart state: ${summary}`);
+        return {
+            content: texts.map((text) => ({ type: 'text', text })),
+        };
+    });
+    const wss = new WebSocketServer({ port: wsPort, host: wsHost });
+    wss.on('error', (err) => {
+        console.error(`[MCP] WebSocket server error: ${err.message}`);
+        if (err.code === 'EADDRINUSE') {
+            console.error(`[MCP] Port ${wsPort} is already in use. Use a different port via WS_PORT env or ws.port option.`);
+        }
+    });
+    wss.on('connection', (ws) => {
+        console.error(`[MCP] WS client connected`);
+        let handle = null;
+        ws.on('message', (raw) => {
+            let msg;
+            try {
+                msg = JSON.parse(raw.toString());
+            }
+            catch {
+                return;
+            }
+            if (msg.type === 'register') {
+                const sessionId = msg.sessionId ?? crypto.randomUUID();
+                handle = new WsSessionHandle(sessionId, ws);
+                registry.register(sessionId, handle);
+                console.error(`[MCP] Session registered: ${sessionId} (total=${registry.getActiveSessionIds().length})`);
+                ws.send(JSON.stringify({ type: 'registered', sessionId }));
+                return;
+            }
+            if (handle) {
+                handle.handleMessage(msg);
+            }
+            if (msg.type === 'state:update' && handle) {
+                registry.updateState(handle.sessionId, msg.descriptions);
+            }
+        });
+        ws.on('close', () => {
+            if (handle) {
+                console.error(`[MCP] Session disconnected: ${handle.sessionId}`);
+                registry.unregister(handle.sessionId);
+            }
+        });
+        ws.on('error', () => {
+            if (handle) {
+                registry.unregister(handle.sessionId);
+            }
+        });
+    });
+    async function start() {
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+    }
+    async function stop() {
+        await server.close();
+        for (const ws of wss.clients) {
+            ws.terminate();
+        }
+        wss.close();
+    }
+    return { server, registry, wss, start, stop };
+}
+//# sourceMappingURL=mcpServer.js.map