cryptoquant-mcp 0.2.0 → 1.0.0

package/README.md

@@ -1,107 +1,74 @@
-# CryptoQuant MCP Server
+# CryptoQuant MCP
 
-<p align="center">
-  <strong>On-Chain Analytics for Claude and AI Coding Agents</strong>
-</p>
+[![npm version](https://img.shields.io/npm/v/cryptoquant-mcp.svg)](https://www.npmjs.com/package/cryptoquant-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
-<p align="center">
-  <a href="#installation">Installation</a> •
-  <a href="#mcp-tools">MCP Tools</a> •
-  <a href="#authentication">Authentication</a>
-</p>
+CryptoQuant on-chain, market, and derivatives data, plus CryptoQuant Research and QuickTake insights, for AI agents through the [Model Context Protocol](https://modelcontextprotocol.io).
 
----
+This repository contains:
 
-## What is this?
+- **Remote server setup** for `https://mcp.cryptoquant.com/mcp` (recommended; you sign in with OAuth)
+- **An Agent Plugins / Cursor plugin** (`plugin.json`, `mcp.json`, `skills/`) that connects to the remote server and teaches the agent which metric answers which question
+- **A local stdio proxy** (`npx cryptoquant-mcp`) for clients that cannot connect to remote MCP servers. It forwards every message to the remote server unchanged.
 
-CryptoQuant MCP Server brings on-chain analytics directly into your AI assistant:
+<!-- TODO: demo GIF (to be recorded by the CryptoQuant team) -->
 
-- **Natural language queries**: Ask in any language - "비트코인 가격 전망?" or "Is BTC overvalued?"
-- **Real-time metrics**: MVRV, SOPR, Exchange Flows, Funding Rates
-- **Market insights**: AI-powered interpretation of on-chain data
-- **Whale tracking**: Monitor large holder movements
+## Remote server (recommended)
 
----
+Server URL: `https://mcp.cryptoquant.com/mcp` (Streamable HTTP, OAuth)
 
-## Installation
+No API key is needed in your config. The first time you connect, your client opens a CryptoQuant sign-in page. More setup details: [CryptoQuant user guide](https://userguide.cryptoquant.com/api/mcp-server-beta/remote-mcp-recommended).
 
-### Quick Start (Claude Desktop, Cursor, etc.)
+### Claude (claude.ai and Claude Desktop)
 
-**Step 1**: Add to your MCP config file:
+Open **Settings → Connectors → Add custom connector** and paste the server URL.
 
-| App | Config File |
-|-----|-------------|
-| **Claude Desktop (Mac)** | `~/Library/Application Support/Claude/claude_desktop_config.json` |
-| **Claude Desktop (Windows)** | `%APPDATA%\Claude\claude_desktop_config.json` |
-| **Claude Code** | `~/.claude/mcp.json` or project `.mcp.json` |
-| **Cursor** | Project `.cursor/mcp.json` |
+### ChatGPT
+
+Add a custom connector with the server URL (developer mode). Availability depends on your ChatGPT plan.
+
+### Cursor
+
+Install the **CryptoQuant** plugin from the Cursor marketplace (once listed). It adds the remote server and the `cryptoquant-onchain` skill.
+
+Or add the server yourself in `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):
 
 ```json
 {
   "mcpServers": {
     "cryptoquant": {
-      "command": "npx",
-      "args": ["-y", "cryptoquant-mcp"]
+      "url": "https://mcp.cryptoquant.com/mcp"
     }
   }
 }
 ```
 
-**Step 2**: Restart your app
+### VS Code
 
-**Step 3**: Call `initialize()` to verify connection. Done!
+`.vscode/mcp.json`:
 
-### Local Development
+```json
+{
+  "servers": {
+    "cryptoquant": {
+      "type": "http",
+      "url": "https://mcp.cryptoquant.com/mcp"
+    }
+  }
+}
+```
 
-For contributors:
+### Claude Code
 
 ```bash
-git clone https://github.com/CryptoQuantOfficial/cryptoquant-mcp.git
-cd cryptoquant-mcp
-npm install && npm run build
+claude mcp add --transport http cryptoquant https://mcp.cryptoquant.com/mcp
 ```
 
----
-
-## MCP Tools
-
-The MCP server provides these tools for API access:
-
-| Tool | Description |
-|------|-------------|
-| `initialize` | Start session with API key, returns plan info |
-| `discover_endpoints` | Browse 245+ available endpoints |
-| `get_endpoint_info` | Get endpoint parameter details |
-| `query_data` | Query raw API data |
-| `describe_metric` | Get metric descriptions and thresholds |
-| `list_assets` | List supported assets |
-| `reset_session` | Clear session (logout) |
-
-### Supported Assets
-
-BTC, ETH, ALT, Stablecoin, ERC20, TRX, XRP
-
----
+Then run `/mcp` in Claude Code to sign in.
 
-## Natural Language Queries
+## Local install (npx proxy)
 
-Ask questions in any language - Claude will route to the right metrics:
-
-| Query | Intent | Metric |
-|-------|--------|--------|
-| "비트코인 가격 전망이 어때?" | VALUATION | MVRV |
-| "Is BTC overvalued?" | VALUATION | MVRV |
-| "고래들 움직임 보여줘" | WHALE_ACTIVITY | whale-ratio |
-| "What's the funding rate?" | LEVERAGE | funding-rates |
-| "익절/손절 상황?" | PROFIT_BEHAVIOR | SOPR |
-
----
-
-## Authentication
-
-### Option A. Environment Variable (Recommended)
-
-Add your API key to the MCP config:
+For clients that only support local (stdio) servers. Requires Node.js 18+ and a [CryptoQuant API key](https://cryptoquant.com/account/api).
 
 ```json
 {
@@ -117,67 +84,66 @@ Add your API key to the MCP config:
 }
 ```
 
-### Option B. Direct Parameter
+| App | Config file |
+| --- | --- |
+| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| Claude Desktop (Windows) | `%APPDATA%\Claude\claude_desktop_config.json` |
+| Cursor | `.cursor/mcp.json` or `~/.cursor/mcp.json` |
+| Claude Code | project `.mcp.json` |
 
-Call `initialize()` with your API key:
+| Variable | Required | Description |
+| --- | --- | --- |
+| `CRYPTOQUANT_API_KEY` | Yes | Your API key, sent to the remote server as a bearer token. If it is not set, the key saved by 0.x in `~/.cryptoquant/credentials` is used. |
+| `CRYPTOQUANT_MCP_URL` | No | Overrides the server URL (default `https://mcp.cryptoquant.com/mcp`). Must be `https`; plain `http` is accepted only for loopback addresses (`localhost`, `127.0.0.1`, `[::1]`). |
 
-```
-initialize(api_key="your-api-key")
-```
-
-The key will be saved to `~/.cryptoquant/credentials` for future sessions.
-
-**Get your API key**: [https://cryptoquant.com/settings/api](https://cryptoquant.com/settings/api)
+Without a key, the proxy prints setup instructions to stderr and exits.
 
-### Managing Credentials
+## Tools
 
-```bash
-# Switch accounts
-reset_session(clear_stored=true)
-initialize(api_key="new-api-key")
-```
+The tools come from the remote server. This list is for reference and may change.
 
----
+| Tool | Description |
+| --- | --- |
+| `discover_endpoints` | Find data endpoints by asset and category |
+| `get_endpoint_info` | Parameters of an endpoint (window, exchange, token, ...) |
+| `query_data` | Query on-chain, market, and derivatives data |
+| `describe_metric` | Definition, thresholds, and interpretation of a metric |
+| `list_assets` | Supported assets |
+| `recent_research` | Latest CryptoQuant Research articles |
+| `recent_quicktake` | Latest QuickTake articles from CryptoQuant Verified Authors |
+| `query_research` | Search Research articles by topic |
+| `query_quicktake` | Search QuickTake articles by topic |
 
-## Requirements
+## Assets, dates, and rate limits
 
-| Component | Requirement |
-|-----------|-------------|
-| Node.js | v18+ |
-| API Access | [CryptoQuant API key](https://cryptoquant.com/settings/api) |
+- **Assets:** BTC, ETH, XRP, TRX, stablecoins, ERC-20 tokens, and other altcoins. `list_assets` returns the current list.
+- **Dates:** `yyyyMMdd` for `window=day` (e.g. `20260115`), `yyyyMMddTHHmmss` for other windows (e.g. `20260115T000000`).
+- **Rate limits and history:** depend on your CryptoQuant plan. The server tells the agent your plan's limits when it connects. See [plans](https://cryptoquant.com/pricing).
 
----
+## Migrating from 0.x
 
-## License
+1.0 turns the npm package into a proxy to the remote server, so the local and remote servers now offer the same tools.
 
-MIT License - see [LICENSE](LICENSE)
+- The `initialize` and `reset_session` tools are removed. Set `CRYPTOQUANT_API_KEY` in your MCP config instead. A key you saved in 0.x with `initialize(api_key=...)` keeps working; it is read from `~/.cryptoquant/credentials`.
+- QuickTake and Research tools are now available locally.
+- The package no longer exports a JavaScript library API.
+- `CRYPTOQUANT_API_URL` (the 0.x API base URL override) is no longer used; use `CRYPTOQUANT_MCP_URL` to point at another MCP server.
+- `npx -y cryptoquant-mcp` always fetches the latest version, so existing configs switch to 1.0 on the next start. Prompts or workflows that call `initialize` need to be updated.
 
----
+See [CHANGELOG.md](CHANGELOG.md).
 
 ## Development
 
-### Setup
-
-After cloning the repository, install dependencies to set up git hooks:
-
 ```bash
+git clone https://github.com/CryptoQuantOfficial/cryptoquant-mcp.git
+cd cryptoquant-mcp
 npm install
+npm test
+npm run build
 ```
 
-This automatically configures [husky](https://typicode.github.io/husky/) for pre-commit hooks.
-
-### Pre-commit Hooks
-
-When committing changes to `src/`, ESLint runs automatically:
+See [CONTRIBUTING.md](CONTRIBUTING.md).
 
-- Lint check runs only when files in `src/` are staged
-- Commit is blocked if lint errors are found
-- Fix errors before committing: `npm run lint`
-
----
+## License
 
-<p align="center">
-  <a href="https://cryptoquant.com">CryptoQuant</a> •
-  <a href="https://docs.cryptoquant.com">Docs</a> •
-  <a href="https://github.com/CryptoQuantOfficial/cryptoquant-mcp/issues">Issues</a>
-</p>
+MIT. See [LICENSE](LICENSE).

package/dist/api-key.js

@@ -0,0 +1,76 @@
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { DEFAULT_MCP_URL } from "./config.js";
+export const API_KEY_URL = "https://cryptoquant.com/account/api";
+export function credentialsPath(home = homedir()) {
+    return join(home, ".cryptoquant", "credentials");
+}
+function clean(value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+/** Reads the key that 0.x saved via initialize(api_key=...). Never writes. */
+function readStoredKey(path) {
+    try {
+        const data = JSON.parse(readFileSync(path, "utf-8"));
+        if (data === null || typeof data !== "object" || Array.isArray(data))
+            return null;
+        return clean(data.api_key);
+    }
+    catch {
+        return null;
+    }
+}
+export function resolveApiKey({ env = process.env, home = homedir(), } = {}) {
+    const fromEnv = clean(env.CRYPTOQUANT_API_KEY);
+    if (fromEnv)
+        return { key: fromEnv, source: "env" };
+    const fromFile = readStoredKey(credentialsPath(home));
+    if (fromFile)
+        return { key: fromFile, source: "credentials" };
+    return null;
+}
+/** Printable ASCII only: anything else cannot be sent in an Authorization header. */
+export function isValidApiKey(key) {
+    return /^[\x21-\x7E]+$/.test(key);
+}
+export function keySourceLabel(source) {
+    return source === "env" ? "CRYPTOQUANT_API_KEY" : "~/.cryptoquant/credentials";
+}
+/** Never includes the key or any part of it. */
+export function invalidKeyMessage(source) {
+    return [
+        `[cryptoquant-mcp] The API key from ${keySourceLabel(source)} contains invalid characters`,
+        "(only printable ASCII without spaces is allowed). Check for stray quotes, line breaks, or spaces.",
+        "",
+        `Get an API key: ${API_KEY_URL}`,
+        "",
+    ].join("\n");
+}
+export function missingKeyMessage() {
+    return [
+        "[cryptoquant-mcp] No CryptoQuant API key found.",
+        "",
+        "Set CRYPTOQUANT_API_KEY in your MCP client config:",
+        "",
+        "  {",
+        '    "mcpServers": {',
+        '      "cryptoquant": {',
+        '        "command": "npx",',
+        '        "args": ["-y", "cryptoquant-mcp"],',
+        '        "env": { "CRYPTOQUANT_API_KEY": "<your-api-key>" }',
+        "      }",
+        "    }",
+        "  }",
+        "",
+        `Get an API key: ${API_KEY_URL}`,
+        "",
+        "If your client supports remote MCP servers, connect to the remote server instead",
+        `and sign in with OAuth (no API key in your config): ${DEFAULT_MCP_URL}`,
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=api-key.js.map

package/dist/api-key.js.map

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

package/dist/config.js

@@ -1,23 +1,29 @@
-/**
- * Centralized configuration for CryptoQuant MCP Server
- *
- * API URL Priority:
- * 1. CRYPTOQUANT_API_URL environment variable (optional override)
- * 2. Default production URL
- */
-const DEFAULT_API_URL = "https://api.cryptoquant.com/v1";
-/**
- * Get the configured API URL.
- * Returns the base URL with /v1 suffix (e.g., "https://api.cryptoquant.com/v1")
- */
-export function getApiUrl() {
-    return process.env.CRYPTOQUANT_API_URL || DEFAULT_API_URL;
+export const DEFAULT_MCP_URL = "https://mcp.cryptoquant.com/mcp";
+export class ConfigError extends Error {
+    name = "ConfigError";
+}
+function isLoopback(hostname) {
+    return hostname === "localhost" || hostname === "[::1]" || /^127(\.\d{1,3}){3}$/.test(hostname);
 }
 /**
- * Get the API base URL without version suffix.
- * Returns the base URL (e.g., "https://api.cryptoquant.com")
+ * CRYPTOQUANT_MCP_URL overrides the server (stage testing). The API key travels
+ * in a header, so plain http is allowed only when it cannot leave the machine.
  */
-export function getApiBaseUrl() {
-    return getApiUrl().replace(/\/v1$/, "");
+export function resolveServerUrl(env = process.env) {
+    const raw = env.CRYPTOQUANT_MCP_URL?.trim();
+    if (!raw)
+        return new URL(DEFAULT_MCP_URL);
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        throw new ConfigError("CRYPTOQUANT_MCP_URL is not a valid URL.");
+    }
+    if (url.protocol === "https:")
+        return url;
+    if (url.protocol === "http:" && isLoopback(url.hostname))
+        return url;
+    throw new ConfigError("CRYPTOQUANT_MCP_URL must use https (plain http is allowed only for localhost, 127.0.0.0/8, and [::1]).");
 }
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,eAAe,GAAG,gCAAgC,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,eAAe,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,SAAS,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,iCAAiC,CAAC;AAEjE,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,GAAG,aAAa,CAAC;CAC/B;AAED,SAAS,UAAU,CAAC,QAAgB;IAClC,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,OAAO,IAAI,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAClG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACnE,MAAM,GAAG,GAAG,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC;IAC5C,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC;IAE1C,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,WAAW,CAAC,yCAAyC,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IAC1C,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,GAAG,CAAC;IACrE,MAAM,IAAI,WAAW,CACnB,wGAAwG,CACzG,CAAC;AACJ,CAAC"}

package/dist/index.js

@@ -1,47 +1,40 @@
 #!/usr/bin/env node
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { registerAuthTools } from "./tools/auth.js";
-import { registerCoreTools } from "./tools/core.js";
+import { invalidKeyMessage, isValidApiKey, keySourceLabel, missingKeyMessage, resolveApiKey } from "./api-key.js";
+import { ConfigError, resolveServerUrl } from "./config.js";
+import { startProxy } from "./proxy.js";
 import { logger } from "./utils.js";
-export { fetchDiscoveryEndpoints, getEndpointCatalog, isDiscoveryLoaded, searchEndpoints, getEndpointByPath, getParameterOptions, getDiscoverySummary, getAssetCategoryMap, resetDiscovery, } from "./discovery.js";
-export { initializePermissions, getPermissionState, setGuestMode, resetPermissions, clearDiscoveryCache, getDiscoveryCachePath, getCachedDiscovery, } from "./permissions.js";
-export { fetchPlanLimits, getPlanLimitsState, getPlanLimit, getEndpointResultLimit, getEndpointWindowLimits, hasEndpointAccess, parseDurationToDate, getEarliestAllowedDate, validateDateRange, getRequiredPlan, getApiRateLimit, getStaticEndpoints, resetPlanLimits, loadPlanLimitsFromCache, getAccessibleEndpointsSummary, detectPlanFromLimits, } from "./plan-limits.js";
-export { CACHE_VERSION, CACHE_TTL_DAYS } from "./cache/types.js";
-export { getCacheFilePath, isCacheValid, readCache, writeCache, invalidateCache, clearAllCaches, getCacheAgeDays, getCacheStatus, getCachePath, } from "./cache/storage.js";
-export { generateSummary, extractRawResponse } from "./cache/summary.js";
-export { getStoredApiKey, saveApiKey, updateValidatedAt, clearCredentials, getCredentialsPath, } from "./auth/storage.js";
-// =============================================================================
-// Utility Exports
-// =============================================================================
-export { jsonResponse, errorResponse, getPlanNote, capitalizeFirst, logger, } from "./utils.js";
-// =============================================================================
-// Config Exports
-// =============================================================================
-export { getApiUrl, getApiBaseUrl } from "./config.js";
-// =============================================================================
-// Tool Registration Exports
-// =============================================================================
-export { registerAuthTools } from "./tools/auth.js";
-export { registerCoreTools } from "./tools/core.js";
-// =============================================================================
-// MCP Server Startup
-// =============================================================================
 async function main() {
-    const server = new McpServer({
-        name: "cryptoquant",
-        version: "1.0.0",
-    });
-    // Register tool categories
-    registerAuthTools(server);
-    registerCoreTools(server);
-    // Start server with stdio transport
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    logger.info("CryptoQuant MCP Server running on stdio");
+    let url;
+    try {
+        url = resolveServerUrl();
+    }
+    catch (error) {
+        if (error instanceof ConfigError) {
+            process.stderr.write(`[cryptoquant-mcp] ${error.message}\n`);
+            return 1;
+        }
+        throw error;
+    }
+    const resolved = resolveApiKey();
+    if (!resolved) {
+        process.stderr.write(missingKeyMessage());
+        return 1;
+    }
+    if (!isValidApiKey(resolved.key)) {
+        process.stderr.write(invalidKeyMessage(resolved.source));
+        return 1;
+    }
+    logger.info(`CryptoQuant MCP proxy → ${url.origin}${url.pathname} (API key from ${keySourceLabel(resolved.source)})`);
+    const proxy = await startProxy({ url, apiKey: resolved.key });
+    await proxy.closed;
+    return 0;
 }
-main().catch((error) => {
-    logger.error("Failed to start server:", error);
+main().then((code) => {
+    // Let stdout/stderr drain instead of exiting mid-write; force exit if a handle lingers.
+    process.exitCode = code;
+    setTimeout(() => process.exit(code), 1_000).unref();
+}, (error) => {
+    logger.error("Fatal:", error instanceof Error ? error.message : String(error));
     process.exit(1);
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAcpC,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,GACf,MAAM,gBAAgB,CAAC;AAOxB,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAkB1B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAa1B,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEjE,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,UAAU,EACV,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAOzE,OAAO,EACL,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAChF,OAAO,EACL,YAAY,EACZ,aAAa,EACb,WAAW,EACX,eAAe,EACf,MAAM,GACP,MAAM,YAAY,CAAC;AAEpB,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAChF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEvD,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAChF,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,2BAA2B;IAC3B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,oCAAoC;IACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,MAAM,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;AACzD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClH,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,KAAK,UAAU,IAAI;IACjB,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,gBAAgB,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;YACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;YAC7D,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACzD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,2BAA2B,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,QAAQ,kBAAkB,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAEtH,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;IAC9D,MAAM,KAAK,CAAC,MAAM,CAAC;IACnB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,IAAI,EAAE,CAAC,IAAI,CACT,CAAC,IAAI,EAAE,EAAE;IACP,wFAAwF;IACxF,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IACxB,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;AACtD,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;IACjB,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CACF,CAAC"}

package/dist/proxy.js

@@ -0,0 +1,133 @@
+import { StreamableHTTPClientTransport, StreamableHTTPError } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { API_KEY_URL } from "./api-key.js";
+import { logger } from "./utils.js";
+export const API_KEY_REJECTED = -32001;
+export const UPSTREAM_ERROR = -32603;
+export const DEFAULT_REQUEST_TIMEOUT_MS = 120_000;
+function isRequest(message) {
+    return "method" in message && "id" in message && message.id !== undefined;
+}
+function isResponse(message) {
+    return "id" in message && !("method" in message) && ("result" in message || "error" in message);
+}
+function label(message) {
+    return "method" in message ? message.method : "response";
+}
+function summarize(error, redact) {
+    const message = error instanceof Error ? error.message : String(error);
+    const cause = error instanceof Error && error.cause instanceof Error ? ` (${error.cause.message})` : "";
+    const text = redact(`${message}${cause}`);
+    return text.length > 300 ? `${text.slice(0, 297)}...` : text;
+}
+function toRpcError(error, redact) {
+    if (error instanceof StreamableHTTPError && error.code === 401) {
+        return {
+            code: API_KEY_REJECTED,
+            message: `CryptoQuant rejected the API key. Check CRYPTOQUANT_API_KEY, or create a key at ${API_KEY_URL}`,
+        };
+    }
+    return { code: UPSTREAM_ERROR, message: `CryptoQuant MCP server request failed: ${summarize(error, redact)}` };
+}
+/**
+ * Relays JSON-RPC between a stdio MCP client and the remote Streamable HTTP server.
+ * Messages are forwarded as is; the proxy only answers on the server's behalf when
+ * a request cannot reach it (401, network, 5xx, timeout).
+ */
+export async function startProxy(options) {
+    const stdin = options.stdin ?? process.stdin;
+    const stdout = options.stdout ?? process.stdout;
+    const timeoutMs = options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+    const local = new StdioServerTransport(stdin, stdout);
+    const remote = new StreamableHTTPClientTransport(options.url, {
+        requestInit: { headers: { Authorization: `Bearer ${options.apiKey}` } },
+    });
+    // The one place that scrubs the key from anything that can reach stdout or stderr.
+    const redact = (text) => (options.apiKey ? text.split(options.apiKey).join("***") : text);
+    const pending = new Map();
+    let closing = false;
+    let markClosed;
+    const closed = new Promise((resolve) => {
+        markClosed = resolve;
+    });
+    const reply = (message) => {
+        if (closing)
+            return;
+        local.send(message).catch((error) => logger.error("Failed to write to stdout:", summarize(error, redact)));
+    };
+    const settle = (id) => {
+        const entry = pending.get(id);
+        if (!entry)
+            return undefined;
+        clearTimeout(entry.timer);
+        pending.delete(id);
+        return entry;
+    };
+    const fail = (id, error) => {
+        if (!settle(id))
+            return; // already answered or timed out
+        reply({ jsonrpc: "2.0", id, error });
+    };
+    remote.onmessage = (message) => {
+        if (isResponse(message)) {
+            const entry = settle(message.id);
+            if (!entry) {
+                logger.warn(`Dropping a late or unknown response (id ${String(message.id)})`);
+                return;
+            }
+            if (entry.method === "initialize" && "result" in message) {
+                const version = message.result.protocolVersion;
+                if (typeof version === "string")
+                    remote.setProtocolVersion(version);
+            }
+        }
+        reply(message);
+    };
+    // The SDK reports a failed send() here as well as by rejecting it, so this is the single
+    // warn for request failures; the send() catch below only builds the JSON-RPC error.
+    remote.onerror = (error) => {
+        if (closing || error.name === "AbortError")
+            return;
+        logger.warn("Remote transport error:", summarize(error, redact));
+    };
+    local.onmessage = (message) => {
+        if (isRequest(message)) {
+            const id = message.id;
+            settle(id); // a client reusing a pending id must not leave the old timer running
+            const timer = setTimeout(() => fail(id, { code: UPSTREAM_ERROR, message: `CryptoQuant MCP server did not respond within ${timeoutMs / 1000}s` }), timeoutMs);
+            pending.set(id, { method: message.method, timer });
+        }
+        if ("method" in message && message.method === "notifications/cancelled" && "params" in message) {
+            const requestId = message.params?.requestId;
+            if (typeof requestId === "string" || typeof requestId === "number")
+                settle(requestId);
+        }
+        remote.send(message).catch((error) => {
+            if (isRequest(message)) {
+                fail(message.id, toRpcError(error, redact));
+            }
+            else {
+                logger.warn(`Failed to forward ${label(message)}:`, summarize(error, redact));
+            }
+        });
+    };
+    local.onerror = (error) => logger.warn("Invalid message from client:", summarize(error, redact));
+    const shutdown = async () => {
+        if (closing)
+            return closed;
+        closing = true;
+        for (const entry of pending.values())
+            clearTimeout(entry.timer);
+        pending.clear();
+        await remote.close().catch(() => undefined);
+        await local.close().catch(() => undefined);
+        markClosed();
+        return closed;
+    };
+    stdin.once("end", () => void shutdown());
+    stdin.once("close", () => void shutdown());
+    await remote.start();
+    await local.start();
+    return { closed, close: shutdown };
+}
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,6BAA6B,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAC;AACxH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAGjF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAK,CAAC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAuBlD,SAAS,SAAS,CAAC,OAAuB;IACxC,OAAO,QAAQ,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,IAAI,OAAO,CAAC,EAAE,KAAK,SAAS,CAAC;AAC5E,CAAC;AAED,SAAS,UAAU,CAAC,OAAuB;IACzC,OAAO,IAAI,IAAI,OAAO,IAAI,CAAC,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,OAAO,IAAI,OAAO,IAAI,OAAO,CAAC,CAAC;AAClG,CAAC;AAED,SAAS,KAAK,CAAC,OAAuB;IACpC,OAAO,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;AAC3D,CAAC;AAED,SAAS,SAAS,CAAC,KAAc,EAAE,MAAc;IAC/C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACxG,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC;AAID,SAAS,UAAU,CAAC,KAAc,EAAE,MAAc;IAChD,IAAI,KAAK,YAAY,mBAAmB,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;QAC/D,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,mFAAmF,WAAW,EAAE;SAC1G,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,0CAA0C,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;AACjH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAqB;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAChD,MAAM,SAAS,GAAG,OAAO,CAAC,gBAAgB,IAAI,0BAA0B,CAAC;IAEzE,MAAM,KAAK,GAAG,IAAI,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,6BAA6B,CAAC,OAAO,CAAC,GAAG,EAAE;QAC5D,WAAW,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,MAAM,EAAE,EAAE,EAAE;KACxE,CAAC,CAAC;IAEH,mFAAmF;IACnF,MAAM,MAAM,GAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAElG,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;IACrD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,UAAuB,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAC3C,UAAU,GAAG,OAAO,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,CAAC,OAAuB,EAAQ,EAAE;QAC9C,IAAI,OAAO;YAAE,OAAO;QACpB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7G,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,EAAa,EAA8B,EAAE;QAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,CAAC,EAAa,EAAE,KAAwC,EAAQ,EAAE;QAC7E,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAAE,OAAO,CAAC,gCAAgC;QACzD,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC;IAEF,MAAM,CAAC,SAAS,GAAG,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACjC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,CAAC,2CAA2C,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;gBAC9E,OAAO;YACT,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,KAAK,YAAY,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;gBACzD,MAAM,OAAO,GAAI,OAAO,CAAC,MAAwC,CAAC,eAAe,CAAC;gBAClF,IAAI,OAAO,OAAO,KAAK,QAAQ;oBAAE,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC,CAAC;IACF,yFAAyF;IACzF,oFAAoF;IACpF,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE;QACzB,IAAI,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO;QACnD,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IACnE,CAAC,CAAC;IAEF,KAAK,CAAC,SAAS,GAAG,CAAC,OAAO,EAAE,EAAE;QAC5B,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;YACtB,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,qEAAqE;YACjF,MAAM,KAAK,GAAG,UAAU,CACtB,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,iDAAiD,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC,EACvH,SAAS,CACV,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,QAAQ,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,yBAAyB,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;YAC/F,MAAM,SAAS,GAAI,OAAO,CAAC,MAA8C,EAAE,SAAS,CAAC;YACrF,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,OAAO,SAAS,KAAK,QAAQ;gBAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACxF,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACnC,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvB,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,qBAAqB,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;YAChF,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,KAAK,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAEjG,MAAM,QAAQ,GAAG,KAAK,IAAmB,EAAE;QACzC,IAAI,OAAO;YAAE,OAAO,MAAM,CAAC;QAC3B,OAAO,GAAG,IAAI,CAAC;QACf,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE;YAAE,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChE,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC3C,UAAU,EAAE,CAAC;QACb,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;IAE3C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IAEpB,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACrC,CAAC"}