bitbank-lab-mcp 0.1.0

package/lib/validate.ts

@@ -0,0 +1,154 @@
+import type { Pair } from '../src/schemas.js';
+import { nowIso } from './datetime.js';
+
+// bitbank 公式ペアリスト（アクティブなもののみ）
+// 参考: https://github.com/bitbankinc/bitbank-api-docs/blob/master/pairs.md
+export const ALLOWED_PAIRS: Set<Pair> = new Set([
+	// 主要ペア
+	'btc_jpy',
+	'eth_jpy',
+	'xrp_jpy',
+	'ltc_jpy',
+	'bcc_jpy',
+	// アルトコイン
+	'mona_jpy',
+	'xlm_jpy',
+	'qtum_jpy',
+	'bat_jpy',
+	'omg_jpy',
+	'xym_jpy',
+	'link_jpy',
+	'boba_jpy',
+	'enj_jpy',
+	'dot_jpy',
+	'doge_jpy',
+	'astr_jpy',
+	'ada_jpy',
+	'avax_jpy',
+	'axs_jpy',
+	'flr_jpy',
+	'sand_jpy',
+	'gala_jpy',
+	'ape_jpy',
+	'chz_jpy',
+	'oas_jpy',
+	'mana_jpy',
+	'grt_jpy',
+	'bnb_jpy',
+	'dai_jpy',
+	'op_jpy',
+	'arb_jpy',
+	'klay_jpy',
+	'imx_jpy',
+	'mask_jpy',
+	'pol_jpy', // 旧 matic_jpy
+	'sol_jpy',
+	'cyber_jpy',
+	'render_jpy', // 旧 rndr_jpy
+	'trx_jpy',
+	'lpt_jpy',
+	'atom_jpy',
+	'sui_jpy',
+	'sky_jpy', // 旧 mkr_jpy
+]);
+
+export function normalizePair(raw: unknown): Pair | null {
+	if (!raw) return null;
+	const s = String(raw).trim().toLowerCase();
+	// Zodバリデーション済みの場合、形式変換（BTC/JPY → btc_jpy）は不要
+	// 正規形式（xxx_yyy）以外は null を返す
+	if (!/^[a-z0-9]+_[a-z0-9]+$/.test(s)) return null;
+	return s as Pair;
+}
+
+export function ensurePair(
+	pair: unknown,
+): { ok: true; pair: Pair } | { ok: false; error: { type: 'user' | 'internal'; message: string } } {
+	const norm = normalizePair(pair);
+	if (!norm) {
+		return {
+			ok: false,
+			error: { type: 'user', message: `pair '${String(pair)}' が不正です（例: btc_jpy）` },
+		};
+	}
+	if (!ALLOWED_PAIRS.has(norm)) {
+		return {
+			ok: false,
+			error: {
+				type: 'user',
+				message: `未対応のpair: '${norm}'（対応例: ${[...ALLOWED_PAIRS].slice(0, 5).join(', ')}...）`,
+			},
+		};
+	}
+	return { ok: true, pair: norm };
+}
+
+export function validateLimit(
+	limit: unknown,
+	min = 1,
+	max = 1000,
+	paramName = 'limit',
+): { ok: true; value: number } | { ok: false; error: { type: 'user' | 'internal'; message: string } } {
+	const num = Number(limit);
+	if (!Number.isInteger(num) || num < min || num > max) {
+		return {
+			ok: false,
+			error: {
+				type: 'user',
+				message: `${paramName} は ${min}〜${max} の整数で指定してください（指定値: ${String(limit)}）`,
+			},
+		};
+	}
+	return { ok: true, value: num };
+}
+
+export function validateDate(
+	date: string,
+	type: string | null = null,
+): { ok: true; value: string } | { ok: false; error: { type: 'user' | 'internal'; message: string } } {
+	if (type) {
+		// YYYYMMDD が必要なタイプ（分足～1時間足）
+		const TYPES_REQUIRE_YYYYMMDD = new Set(['1min', '5min', '15min', '30min', '1hour']);
+
+		if (TYPES_REQUIRE_YYYYMMDD.has(type)) {
+			if (!/^\d{8}$/.test(date)) {
+				return {
+					ok: false,
+					error: {
+						type: 'user',
+						message: `${type} の場合、date は YYYYMMDD 形式で指定してください（指定値: ${date}）`,
+					},
+				};
+			}
+			return { ok: true, value: date };
+		} else {
+			// 4hour/8hour/12hour 以上は YYYY 単位で取得（公式仕様）
+			if (!/^\d{4,8}$/.test(date)) {
+				return {
+					ok: false,
+					error: { type: 'user', message: `date は YYYY または YYYYMMDD 形式で指定してください（指定値: ${date}）` },
+				};
+			}
+			return { ok: true, value: String(date).substring(0, 4) };
+		}
+	}
+
+	if (!/^\d{4,8}$/.test(date)) {
+		return {
+			ok: false,
+			error: { type: 'user', message: `date は YYYY または YYYYMMDD 形式で指定してください（指定値: ${date}）` },
+		};
+	}
+	return { ok: true, value: date };
+}
+
+export function createMeta(
+	pair: Pair,
+	additional: Record<string, unknown> = {},
+): Record<string, unknown> & { pair: Pair; fetchedAt: string } {
+	return {
+		pair,
+		fetchedAt: nowIso(),
+		...additional,
+	};
+}

package/lib/volatility.ts

@@ -0,0 +1,132 @@
+/**
+ * lib/volatility.ts - ボラティリティ推定量の共通計算モジュール
+ *
+ * OHLC ベースのボラティリティ推定量（Parkinson, Garman-Klass, Rogers-Satchell）と
+ * リターンベースの計算を提供。
+ *
+ * 【共通仕様】
+ * - 入力: number[]（古い順）
+ * - 出力: number[]（各キャンドルごとのコンポーネント値）
+ * - 丸め処理なし（呼び出し元で必要に応じて丸める）
+ * - safeLog を使用し、ゼロ / 負値入力に対して安全
+ */
+
+function safeLog(x: number): number {
+	return Math.log(Math.max(x, 1e-12));
+}
+
+/**
+ * 対数リターン系列
+ *
+ * ret[i] = ln(close[i] / close[i-1])  （useLog=true の場合）
+ * ret[i] = (close[i] - close[i-1]) / close[i-1]  （useLog=false の場合）
+ *
+ * @param closes 終値配列（古い順）
+ * @param useLog true で対数リターン、false で単純リターン（デフォルト true）
+ * @returns リターン配列（長さ = closes.length - 1）
+ */
+export function logReturns(closes: number[], useLog: boolean = true): number[] {
+	const result: number[] = [];
+	for (let i = 1; i < closes.length; i++) {
+		const prev = closes[i - 1];
+		const curr = closes[i];
+		if (prev > 0 && curr > 0) {
+			result.push(useLog ? safeLog(curr / prev) : (curr - prev) / prev);
+		} else {
+			result.push(0);
+		}
+	}
+	return result;
+}
+
+/**
+ * Parkinson ボラティリティのコンポーネント系列
+ *
+ * pk[i] = (ln(H/L))^2
+ * 集約: σ_parkinson = sqrt(mean(pk) / (4 * ln(2)))
+ *
+ * @param highs 高値配列（古い順）
+ * @param lows 安値配列（古い順）
+ * @returns per-candle コンポーネント配列
+ */
+export function parkinsonComponents(highs: number[], lows: number[]): number[] {
+	const n = Math.min(highs.length, lows.length);
+	const result: number[] = [];
+	for (let i = 0; i < n; i++) {
+		const logHL = safeLog(highs[i] / Math.max(lows[i], 1e-12));
+		result.push(logHL * logHL);
+	}
+	return result;
+}
+
+/**
+ * Garman-Klass ボラティリティのコンポーネント系列
+ *
+ * gk[i] = 0.5 * (ln(H/L))^2 - (2*ln(2) - 1) * (ln(C/O))^2
+ * 集約: σ_gk = sqrt(mean(gk))
+ *
+ * @param opens 始値配列
+ * @param highs 高値配列
+ * @param lows 安値配列
+ * @param closes 終値配列
+ * @returns per-candle コンポーネント配列
+ */
+export function garmanKlassComponents(opens: number[], highs: number[], lows: number[], closes: number[]): number[] {
+	const n = Math.min(opens.length, highs.length, lows.length, closes.length);
+	const result: number[] = [];
+	for (let i = 0; i < n; i++) {
+		const logHL = safeLog(highs[i] / Math.max(lows[i], 1e-12));
+		const logCO = safeLog(closes[i] / Math.max(opens[i], 1e-12));
+		const pk = logHL * logHL;
+		result.push(0.5 * pk - (2 * Math.log(2) - 1) * (logCO * logCO));
+	}
+	return result;
+}
+
+/**
+ * Rogers-Satchell ボラティリティのコンポーネント系列
+ *
+ * rs[i] = ln(H/C)*ln(H/O) + ln(L/C)*ln(L/O)
+ * 集約: σ_rs = sqrt(mean(rs))
+ *
+ * @param opens 始値配列
+ * @param highs 高値配列
+ * @param lows 安値配列
+ * @param closes 終値配列
+ * @returns per-candle コンポーネント配列
+ */
+export function rogersSatchellComponents(opens: number[], highs: number[], lows: number[], closes: number[]): number[] {
+	const n = Math.min(opens.length, highs.length, lows.length, closes.length);
+	const result: number[] = [];
+	for (let i = 0; i < n; i++) {
+		const h = highs[i];
+		const l = lows[i];
+		const c = closes[i];
+		const o = opens[i];
+		const rs =
+			safeLog(h / Math.max(c, 1e-12)) * safeLog(h / Math.max(o, 1e-12)) +
+			safeLog(l / Math.max(c, 1e-12)) * safeLog(l / Math.max(o, 1e-12));
+		result.push(rs);
+	}
+	return result;
+}
+
+/**
+ * コンポーネント平均からボラティリティ値に変換
+ *
+ * @param componentMean コンポーネント系列の平均値
+ * @param type 推定量タイプ
+ * @returns ボラティリティ値（σ）
+ */
+export function componentMeanToVol(
+	componentMean: number,
+	type: 'parkinson' | 'garmanKlass' | 'rogersSatchell',
+): number {
+	switch (type) {
+		case 'parkinson':
+			return Math.sqrt(Math.max(0, componentMean / (4 * Math.log(2))));
+		case 'garmanKlass':
+		case 'rogersSatchell':
+			return Math.sqrt(Math.max(0, componentMean));
+	}
+}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "bitbank-lab-mcp",
+  "version": "0.1.0",
+  "description": "Experimental MCP server for bitbank — botters lab community edition. Market data, technical analysis, charting, and Private API trading tools.",
+  "type": "module",
+  "bin": {
+    "bitbank-lab-mcp": "bin/bitbank-lab-mcp.js"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tjackiet/bitbank-genesis-mcp-server.git"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "tools/",
+    "lib/",
+    "assets/lightweight-charts.standalone.js",
+    "ui/order-confirm/dist/",
+    "ui/cancel-confirm/dist/",
+    "package.json",
+    "tsconfig.json"
+  ],
+  "scripts": {
+    "start": "tsx src/server.ts",
+    "http": "tsx src/http.ts",
+    "dev": "LOG_LEVEL=debug tsx src/server.ts",
+    "build:ui:order": "vite build --config ui/order-confirm/vite.config.ts",
+    "build:ui": "npm run build:ui:order && npm run build:ui:cancel",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "vitest run --config vitest.config.e2e.ts",
+    "test:coverage": "vitest run --coverage",
+    "stat": "tsx scripts/stat.ts",
+    "report": "tsx scripts/report.ts",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "ci:typecheck": "npm run gen:types && tsc --noEmit -p tsconfig.json",
+    "build": "npm run ci:typecheck",
+    "gen:types": "tsx scripts/gen_types.ts",
+    "lint": "oxlint src/ tools/ lib/",
+    "lint:fix": "oxlint --fix src/ tools/ lib/",
+    "format": "biome format --write src/ tools/ lib/",
+    "format:check": "biome check src/ tools/ lib/",
+    "postinstall": "mkdir -p assets && cp node_modules/lightweight-charts/dist/lightweight-charts.standalone.production.js assets/lightweight-charts.standalone.js || true",
+    "build:ui:cancel": "vite build --config ui/cancel-confirm/vite.config.ts"
+  },
+  "keywords": [],
+  "author": "",
+  "dependencies": {
+    "@modelcontextprotocol/ext-apps": "^1.7.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "dayjs": "^1.11.19",
+    "dotenv": "^17.4.2",
+    "express": "^5.1.0",
+    "express-rate-limit": "^8.3.2",
+    "lightweight-charts": "^5.1.0",
+    "sharp": "^0.34.5",
+    "tsx": "^4.20.6",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.7",
+    "@types/express": "^5.0.4",
+    "@types/node": "^24.5.0",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.1",
+    "@vitest/coverage-v8": "^4.1.2",
+    "lefthook": "^2.1.4",
+    "oxlint": "^1.55.0",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "typescript": "^5.9.3",
+    "vite": "^8.0.10",
+    "vite-plugin-singlefile": "^2.3.3",
+    "vitest": "^4.0.18"
+  }
+}

package/src/env.ts

@@ -0,0 +1,4 @@
+import dotenv from 'dotenv';
+
+// dotenv 17 defaults quiet to false — console.log output on stdout breaks STDIO transport
+dotenv.config({ quiet: true });