crypto-quant-signal-mcp 1.0.0 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +77 -22
- package/dist/index.js +184 -60
- package/dist/index.js.map +1 -1
- package/dist/lib/adapters/hyperliquid.d.ts +14 -0
- package/dist/lib/adapters/hyperliquid.d.ts.map +1 -0
- package/dist/lib/adapters/hyperliquid.js +94 -0
- package/dist/lib/adapters/hyperliquid.js.map +1 -0
- package/dist/lib/exchange-adapter.d.ts +9 -0
- package/dist/lib/exchange-adapter.d.ts.map +1 -0
- package/dist/lib/exchange-adapter.js +16 -0
- package/dist/lib/exchange-adapter.js.map +1 -0
- package/dist/lib/license.d.ts +37 -6
- package/dist/lib/license.d.ts.map +1 -1
- package/dist/lib/license.js +109 -15
- package/dist/lib/license.js.map +1 -1
- package/dist/lib/performance-db.d.ts +2 -3
- package/dist/lib/performance-db.d.ts.map +1 -1
- package/dist/lib/performance-db.js +156 -72
- package/dist/lib/performance-db.js.map +1 -1
- package/dist/lib/x402.d.ts +45 -0
- package/dist/lib/x402.d.ts.map +1 -0
- package/dist/lib/x402.js +89 -0
- package/dist/lib/x402.js.map +1 -0
- package/dist/resources/signal-performance.d.ts.map +1 -1
- package/dist/resources/signal-performance.js +5 -4
- package/dist/resources/signal-performance.js.map +1 -1
- package/dist/tools/get-market-regime.d.ts.map +1 -1
- package/dist/tools/get-market-regime.js +63 -6
- package/dist/tools/get-market-regime.js.map +1 -1
- package/dist/tools/get-trade-signal.d.ts +2 -1
- package/dist/tools/get-trade-signal.d.ts.map +1 -1
- package/dist/tools/get-trade-signal.js +36 -38
- package/dist/tools/get-trade-signal.js.map +1 -1
- package/dist/tools/scan-funding-arb.d.ts +2 -1
- package/dist/tools/scan-funding-arb.d.ts.map +1 -1
- package/dist/tools/scan-funding-arb.js +17 -15
- package/dist/tools/scan-funding-arb.js.map +1 -1
- package/dist/types.d.ts +45 -1
- package/dist/types.d.ts.map +1 -1
- package/package.json +17 -7
- package/server.json +60 -0
- package/smithery.yaml +14 -0
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# crypto-quant-signal-mcp
|
|
2
2
|
|
|
3
|
-
AI trading brain for crypto perps — composite signals, funding rate arb scanning, and market regime detection via MCP. Powered by Hyperliquid data.
|
|
3
|
+
AI trading brain for crypto perps — composite signals, funding rate arb scanning, and market regime detection via MCP. Powered by Hyperliquid data. Remote-first with x402 micropayments.
|
|
4
4
|
|
|
5
5
|
## What It Does
|
|
6
6
|
|
|
@@ -10,18 +10,38 @@ Three opinionated tools + one performance resource that combine multiple indicat
|
|
|
10
10
|
|------|-------------|
|
|
11
11
|
| `get_trade_signal` | Composite BUY/SELL/HOLD signal combining RSI(14), EMA(9/21), funding rate, OI momentum, and volume |
|
|
12
12
|
| `scan_funding_arb` | Cross-venue funding rate arbitrage scanner (Hyperliquid vs Binance vs Bybit) |
|
|
13
|
-
| `get_market_regime` | Market regime classification
|
|
13
|
+
| `get_market_regime` | Market regime classification with cross-venue funding sentiment |
|
|
14
14
|
| `signal-performance` | Historical signal track record — win rate, Sharpe ratio, profit factor |
|
|
15
15
|
|
|
16
|
+
## Architecture
|
|
17
|
+
|
|
18
|
+
```
|
|
19
|
+
Remote Server (revenue-generating)
|
|
20
|
+
Agent → HTTP POST → api.algovault.com/signal/mcp
|
|
21
|
+
→ x402 payment check → API key check → free tier
|
|
22
|
+
→ MCP Server (Streamable HTTP)
|
|
23
|
+
→ PostgreSQL (signal tracking)
|
|
24
|
+
→ Hyperliquid API
|
|
25
|
+
|
|
26
|
+
Local Mode (distribution magnet)
|
|
27
|
+
Claude Desktop → stdio → npx crypto-quant-signal-mcp
|
|
28
|
+
→ Same tools, free tier only
|
|
29
|
+
→ SQLite (local signal tracking)
|
|
30
|
+
→ Hyperliquid API
|
|
31
|
+
```
|
|
32
|
+
|
|
16
33
|
## Quick Start
|
|
17
34
|
|
|
18
|
-
###
|
|
35
|
+
### Remote HTTP (for AI agents)
|
|
19
36
|
|
|
20
|
-
|
|
21
|
-
npm install -g crypto-quant-signal-mcp
|
|
37
|
+
Connect your MCP client to:
|
|
22
38
|
```
|
|
39
|
+
https://api.algovault.com/signal/mcp
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
Pay per call via x402 (USDC on Base) — no signup needed.
|
|
23
43
|
|
|
24
|
-
|
|
44
|
+
### Local Install (for Claude Desktop / Cursor)
|
|
25
45
|
|
|
26
46
|
```bash
|
|
27
47
|
npx -y crypto-quant-signal-mcp
|
|
@@ -38,6 +58,7 @@ Add to your `claude_desktop_config.json`:
|
|
|
38
58
|
"command": "npx",
|
|
39
59
|
"args": ["-y", "crypto-quant-signal-mcp"],
|
|
40
60
|
"env": {
|
|
61
|
+
"TRANSPORT": "stdio",
|
|
41
62
|
"CQS_API_KEY": "your-pro-key-here"
|
|
42
63
|
}
|
|
43
64
|
}
|
|
@@ -45,18 +66,26 @@ Add to your `claude_desktop_config.json`:
|
|
|
45
66
|
}
|
|
46
67
|
```
|
|
47
68
|
|
|
48
|
-
No API key needed for free tier — just remove the `
|
|
69
|
+
No API key needed for free tier — just remove the `CQS_API_KEY` line.
|
|
70
|
+
|
|
71
|
+
## Pricing
|
|
72
|
+
|
|
73
|
+
| Feature | Free | Pro ($49/mo) | Enterprise ($299/mo) | x402 (pay per call) |
|
|
74
|
+
|---------|------|-------------|---------------------|---------------------|
|
|
75
|
+
| `get_trade_signal` | BTC + ETH, 1h only | All 200+ perps, all timeframes | Same + SLA | Full access — $0.02/call |
|
|
76
|
+
| `scan_funding_arb` | Top 5 results | Unlimited | Unlimited | Full access — $0.01/call |
|
|
77
|
+
| `get_market_regime` | All assets | All assets | All assets + SLA | Full access — $0.02/call |
|
|
78
|
+
| `signal-performance` | Full access | Full access | Full access | Free |
|
|
79
|
+
| Monthly calls | ~100/day | 15,000/mo | 100,000/mo | Unlimited |
|
|
80
|
+
| Overage | Hard cap | $0.01/call | $0.005/call | N/A |
|
|
81
|
+
|
|
82
|
+
### x402 Micropayments
|
|
49
83
|
|
|
50
|
-
|
|
84
|
+
AI agents pay per HTTP call with USDC on Base chain — no signup, no API key, no billing. Payment receipt is the credential.
|
|
51
85
|
|
|
52
|
-
|
|
53
|
-
|---------|------|-------------|
|
|
54
|
-
| `get_trade_signal` | BTC + ETH, 1h only | All 200+ perps, 1h/4h/1d |
|
|
55
|
-
| `scan_funding_arb` | Top 5 results | Unlimited |
|
|
56
|
-
| `get_market_regime` | All assets, all timeframes | Same |
|
|
57
|
-
| `signal-performance` | Full access | Full access |
|
|
86
|
+
### API Key
|
|
58
87
|
|
|
59
|
-
Set `CQS_API_KEY` environment variable
|
|
88
|
+
Set `CQS_API_KEY` environment variable or pass `Authorization: Bearer <key>` header. Enterprise keys start with `ent_`.
|
|
60
89
|
|
|
61
90
|
## Example Agent Prompts
|
|
62
91
|
|
|
@@ -66,7 +95,7 @@ Set `CQS_API_KEY` environment variable for Pro access.
|
|
|
66
95
|
**Funding arb scan:**
|
|
67
96
|
> "Scan for funding rate arbitrage opportunities with at least 10 bps spread"
|
|
68
97
|
|
|
69
|
-
**Market regime:**
|
|
98
|
+
**Market regime with cross-venue sentiment:**
|
|
70
99
|
> "What's the current market regime for BTC on the 4h chart?"
|
|
71
100
|
|
|
72
101
|
**Multi-step analysis:**
|
|
@@ -99,7 +128,7 @@ Scans Hyperliquid's `predictedFundings` endpoint for cross-venue funding rate di
|
|
|
99
128
|
|
|
100
129
|
### get_market_regime
|
|
101
130
|
|
|
102
|
-
Classifies market conditions using ADX(14), ATR(14)/price volatility ratio,
|
|
131
|
+
Classifies market conditions using ADX(14), ATR(14)/price volatility ratio, price structure (swing high/low analysis), and cross-venue funding sentiment.
|
|
103
132
|
|
|
104
133
|
**Parameters:**
|
|
105
134
|
- `coin` (string, required): Asset symbol
|
|
@@ -107,17 +136,43 @@ Classifies market conditions using ADX(14), ATR(14)/price volatility ratio, and
|
|
|
107
136
|
|
|
108
137
|
## Performance Tracking
|
|
109
138
|
|
|
110
|
-
Every signal from `get_trade_signal` is
|
|
139
|
+
Every signal from `get_trade_signal` is tracked with outcome prices at 1h, 4h, and 24h intervals. Access the track record via the `performance://signal-stats` MCP resource.
|
|
111
140
|
|
|
112
|
-
|
|
141
|
+
- **Remote mode:** PostgreSQL (server-side, aggregated across all users)
|
|
142
|
+
- **Local mode:** SQLite at `~/.crypto-quant-signal/performance.db` (private to your machine)
|
|
143
|
+
|
|
144
|
+
## Self-Hosting
|
|
145
|
+
|
|
146
|
+
```bash
|
|
147
|
+
git clone https://github.com/AlgoVaultLabs/crypto-quant-signal-mcp
|
|
148
|
+
cd crypto-quant-signal-mcp
|
|
149
|
+
cp .env.example .env # Edit with your values
|
|
150
|
+
npm ci && npm run build
|
|
151
|
+
docker compose up -d
|
|
152
|
+
```
|
|
113
153
|
|
|
114
154
|
## Technical Details
|
|
115
155
|
|
|
116
156
|
- **Data source:** Hyperliquid public API (free, no auth required)
|
|
117
|
-
- **
|
|
118
|
-
- **Storage:**
|
|
119
|
-
- **
|
|
157
|
+
- **Transports:** Streamable HTTP (default, port 3000) + stdio (via `TRANSPORT=stdio`)
|
|
158
|
+
- **Storage:** PostgreSQL (remote) or SQLite (local)
|
|
159
|
+
- **Exchange adapter:** Pluggable — Hyperliquid today, Binance/Bybit adapters in Phase 2
|
|
160
|
+
- **x402 payments:** USDC on Base chain per x402.org spec
|
|
161
|
+
|
|
162
|
+
## Suite Compatibility
|
|
163
|
+
|
|
164
|
+
All tools output an `_algovault` metadata block for composability with future AlgoVault tools:
|
|
165
|
+
|
|
166
|
+
| Tool output | Feeds into (Phase 2+) |
|
|
167
|
+
|------------|----------------------|
|
|
168
|
+
| `get_trade_signal` | `crypto-quant-risk-mcp`, `crypto-quant-backtest-mcp` |
|
|
169
|
+
| `scan_funding_arb` | `crypto-quant-risk-mcp`, `crypto-quant-execution-mcp` |
|
|
170
|
+
| `get_market_regime` | `crypto-quant-risk-mcp`, `crypto-quant-backtest-mcp` |
|
|
120
171
|
|
|
121
172
|
## License
|
|
122
173
|
|
|
123
174
|
MIT
|
|
175
|
+
|
|
176
|
+
---
|
|
177
|
+
|
|
178
|
+
Built by [AlgoVault Labs](https://algovault.com)
|
package/dist/index.js
CHANGED
|
@@ -1,71 +1,96 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
"use strict";
|
|
3
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
4
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
5
|
+
};
|
|
3
6
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
7
|
+
/**
|
|
8
|
+
* crypto-quant-signal-mcp — Dual transport MCP server.
|
|
9
|
+
*
|
|
10
|
+
* Default: Streamable HTTP on port 3000 (remote server mode)
|
|
11
|
+
* Optional: stdio transport via TRANSPORT=stdio env var (local npx use)
|
|
12
|
+
*/
|
|
13
|
+
const node_crypto_1 = __importDefault(require("node:crypto"));
|
|
4
14
|
const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
|
|
5
15
|
const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
|
|
16
|
+
const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
|
|
6
17
|
const zod_1 = require("zod");
|
|
7
18
|
const get_trade_signal_js_1 = require("./tools/get-trade-signal.js");
|
|
8
19
|
const scan_funding_arb_js_1 = require("./tools/scan-funding-arb.js");
|
|
9
20
|
const get_market_regime_js_1 = require("./tools/get-market-regime.js");
|
|
10
21
|
const signal_performance_js_1 = require("./resources/signal-performance.js");
|
|
11
22
|
const performance_db_js_1 = require("./lib/performance-db.js");
|
|
12
|
-
const
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
}
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
}
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
23
|
+
const license_js_1 = require("./lib/license.js");
|
|
24
|
+
function createServer() {
|
|
25
|
+
const server = new mcp_js_1.McpServer({
|
|
26
|
+
name: 'crypto-quant-signal-mcp',
|
|
27
|
+
version: '1.0.0',
|
|
28
|
+
});
|
|
29
|
+
// ── Tool 1: get_trade_signal ──
|
|
30
|
+
server.tool('get_trade_signal', "Returns a composite BUY/SELL/HOLD signal for a Hyperliquid perp. Combines RSI(14), EMA(9/21) crossover, funding rate, OI momentum, and volume into a weighted score with confidence percentage.", {
|
|
31
|
+
coin: zod_1.z.string().describe("Asset symbol, e.g. 'ETH', 'BTC', 'SOL'"),
|
|
32
|
+
timeframe: zod_1.z.enum(['1h', '4h', '1d']).default('1h').describe('Candle timeframe (free: 1h only)'),
|
|
33
|
+
includeReasoning: zod_1.z.boolean().default(true).describe('Include human-readable reasoning'),
|
|
34
|
+
}, async ({ coin, timeframe, includeReasoning }) => {
|
|
35
|
+
try {
|
|
36
|
+
const license = (0, license_js_1.getRequestLicense)();
|
|
37
|
+
(0, license_js_1.trackCall)(license);
|
|
38
|
+
const result = await (0, get_trade_signal_js_1.getTradeSignal)({ coin, timeframe, includeReasoning, license });
|
|
39
|
+
return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
|
|
40
|
+
}
|
|
41
|
+
catch (err) {
|
|
42
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
43
|
+
return { content: [{ type: 'text', text: JSON.stringify({ error: message }) }], isError: true };
|
|
44
|
+
}
|
|
45
|
+
});
|
|
46
|
+
// ── Tool 2: scan_funding_arb ──
|
|
47
|
+
server.tool('scan_funding_arb', 'Scans cross-venue funding rate differences between Hyperliquid, Binance, and Bybit. Returns top arbitrage opportunities ranked by annualized spread.', {
|
|
48
|
+
minSpreadBps: zod_1.z.number().default(5).describe('Minimum spread in basis points to include'),
|
|
49
|
+
limit: zod_1.z.number().default(10).describe('Max results (free: max 5)'),
|
|
50
|
+
}, async ({ minSpreadBps, limit }) => {
|
|
51
|
+
try {
|
|
52
|
+
const license = (0, license_js_1.getRequestLicense)();
|
|
53
|
+
(0, license_js_1.trackCall)(license);
|
|
54
|
+
const result = await (0, scan_funding_arb_js_1.scanFundingArb)({ minSpreadBps, limit, license });
|
|
55
|
+
return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
|
|
56
|
+
}
|
|
57
|
+
catch (err) {
|
|
58
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
59
|
+
return { content: [{ type: 'text', text: JSON.stringify({ error: message }) }], isError: true };
|
|
60
|
+
}
|
|
61
|
+
});
|
|
62
|
+
// ── Tool 3: get_market_regime ──
|
|
63
|
+
server.tool('get_market_regime', 'Classifies the current market regime (TRENDING_UP, TRENDING_DOWN, RANGING, VOLATILE) for a Hyperliquid perp using ADX(14), volatility ratio, price structure, and cross-venue funding sentiment.', {
|
|
64
|
+
coin: zod_1.z.string().describe("Asset symbol, e.g. 'BTC', 'ETH', 'SOL'"),
|
|
65
|
+
timeframe: zod_1.z.enum(['1h', '4h', '1d']).default('4h').describe('Candle timeframe'),
|
|
66
|
+
}, async ({ coin, timeframe }) => {
|
|
67
|
+
try {
|
|
68
|
+
const license = (0, license_js_1.getRequestLicense)();
|
|
69
|
+
(0, license_js_1.trackCall)(license);
|
|
70
|
+
const result = await (0, get_market_regime_js_1.getMarketRegime)({ coin, timeframe });
|
|
71
|
+
return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
|
|
72
|
+
}
|
|
73
|
+
catch (err) {
|
|
74
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
75
|
+
return { content: [{ type: 'text', text: JSON.stringify({ error: message }) }], isError: true };
|
|
76
|
+
}
|
|
77
|
+
});
|
|
78
|
+
// ── Resource: signal-performance ──
|
|
79
|
+
server.resource('signal-stats', 'performance://signal-stats', { description: 'Historical signal performance metrics — win rate, Sharpe ratio, profit factor, and per-asset breakdowns. Updated on each access with latest outcome data.' }, async () => {
|
|
80
|
+
const stats = await (0, signal_performance_js_1.getSignalPerformance)();
|
|
81
|
+
return { contents: [{ uri: 'performance://signal-stats', mimeType: 'application/json', text: JSON.stringify(stats, null, 2) }] };
|
|
82
|
+
});
|
|
83
|
+
return server;
|
|
84
|
+
}
|
|
85
|
+
// ── Stdio Mode ──
|
|
86
|
+
async function startStdio() {
|
|
87
|
+
const server = createServer();
|
|
66
88
|
const transport = new stdio_js_1.StdioServerTransport();
|
|
89
|
+
// Stdio mode: resolve license from env once, set as persistent context.
|
|
90
|
+
// AsyncLocalStorage enterWith() keeps it active for all async work in this context.
|
|
91
|
+
const license = (0, license_js_1.resolveLicense)({});
|
|
92
|
+
license_js_1.requestContext.enterWith({ license });
|
|
67
93
|
await server.connect(transport);
|
|
68
|
-
// Graceful shutdown
|
|
69
94
|
const shutdown = () => {
|
|
70
95
|
(0, performance_db_js_1.closeDb)();
|
|
71
96
|
process.exit(0);
|
|
@@ -73,9 +98,108 @@ async function main() {
|
|
|
73
98
|
process.on('SIGINT', shutdown);
|
|
74
99
|
process.on('SIGTERM', shutdown);
|
|
75
100
|
}
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
101
|
+
// ── HTTP Mode (Streamable HTTP) ──
|
|
102
|
+
async function startHttp() {
|
|
103
|
+
const { default: express } = await import('express');
|
|
104
|
+
const app = express();
|
|
105
|
+
const port = parseInt(process.env.PORT || '3000', 10);
|
|
106
|
+
// Store active transports for session management
|
|
107
|
+
const transports = new Map();
|
|
108
|
+
// Health check
|
|
109
|
+
app.get('/health', (_req, res) => {
|
|
110
|
+
res.json({ status: 'ok', server: 'crypto-quant-signal-mcp', version: '1.0.0' });
|
|
111
|
+
});
|
|
112
|
+
// MCP endpoint
|
|
113
|
+
app.all('/mcp', express.json(), async (req, res) => {
|
|
114
|
+
// Resolve license per-request using 3-tier gate: x402 → API key → free
|
|
115
|
+
const license = (0, license_js_1.resolveLicense)(req.headers);
|
|
116
|
+
// Run the entire request handling inside AsyncLocalStorage context
|
|
117
|
+
// so tool handlers read the correct per-request license
|
|
118
|
+
await license_js_1.requestContext.run({ license }, async () => {
|
|
119
|
+
try {
|
|
120
|
+
const sessionId = req.headers['mcp-session-id'];
|
|
121
|
+
if (req.method === 'GET') {
|
|
122
|
+
if (sessionId && transports.has(sessionId)) {
|
|
123
|
+
const transport = transports.get(sessionId);
|
|
124
|
+
await transport.handleRequest(req, res);
|
|
125
|
+
}
|
|
126
|
+
else {
|
|
127
|
+
res.status(400).json({ error: 'No active session. Send a POST first.' });
|
|
128
|
+
}
|
|
129
|
+
return;
|
|
130
|
+
}
|
|
131
|
+
if (req.method === 'DELETE') {
|
|
132
|
+
if (sessionId && transports.has(sessionId)) {
|
|
133
|
+
const transport = transports.get(sessionId);
|
|
134
|
+
await transport.handleRequest(req, res);
|
|
135
|
+
transports.delete(sessionId);
|
|
136
|
+
}
|
|
137
|
+
else {
|
|
138
|
+
res.status(404).json({ error: 'Session not found' });
|
|
139
|
+
}
|
|
140
|
+
return;
|
|
141
|
+
}
|
|
142
|
+
// POST — main request path
|
|
143
|
+
if (sessionId && transports.has(sessionId)) {
|
|
144
|
+
const transport = transports.get(sessionId);
|
|
145
|
+
await transport.handleRequest(req, res);
|
|
146
|
+
}
|
|
147
|
+
else {
|
|
148
|
+
// New session
|
|
149
|
+
const transport = new streamableHttp_js_1.StreamableHTTPServerTransport({
|
|
150
|
+
sessionIdGenerator: () => node_crypto_1.default.randomUUID(),
|
|
151
|
+
onsessioninitialized: (sid) => {
|
|
152
|
+
transports.set(sid, transport);
|
|
153
|
+
},
|
|
154
|
+
});
|
|
155
|
+
transport.onclose = () => {
|
|
156
|
+
const sid = transport.sessionId;
|
|
157
|
+
if (sid)
|
|
158
|
+
transports.delete(sid);
|
|
159
|
+
};
|
|
160
|
+
const server = createServer();
|
|
161
|
+
await server.connect(transport);
|
|
162
|
+
await transport.handleRequest(req, res);
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
catch (err) {
|
|
166
|
+
if (!res.headersSent) {
|
|
167
|
+
res.status(500).json({ error: 'Internal server error' });
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
});
|
|
171
|
+
});
|
|
172
|
+
const httpServer = app.listen(port, () => {
|
|
173
|
+
console.log(`crypto-quant-signal-mcp running on http://0.0.0.0:${port}/mcp`);
|
|
174
|
+
console.log(`Health check: http://0.0.0.0:${port}/health`);
|
|
175
|
+
});
|
|
176
|
+
const shutdown = () => {
|
|
177
|
+
console.log('Shutting down...');
|
|
178
|
+
for (const transport of transports.values()) {
|
|
179
|
+
transport.close?.();
|
|
180
|
+
}
|
|
181
|
+
transports.clear();
|
|
182
|
+
(0, performance_db_js_1.closeDb)();
|
|
183
|
+
httpServer.close(() => process.exit(0));
|
|
184
|
+
setTimeout(() => process.exit(0), 5000);
|
|
185
|
+
};
|
|
186
|
+
process.on('SIGINT', shutdown);
|
|
187
|
+
process.on('SIGTERM', shutdown);
|
|
188
|
+
}
|
|
189
|
+
// ── Entry Point ──
|
|
190
|
+
const transport = (process.env.TRANSPORT || 'http').toLowerCase();
|
|
191
|
+
if (transport === 'stdio') {
|
|
192
|
+
startStdio().catch((err) => {
|
|
193
|
+
console.error('Fatal:', err);
|
|
194
|
+
(0, performance_db_js_1.closeDb)();
|
|
195
|
+
process.exit(1);
|
|
196
|
+
});
|
|
197
|
+
}
|
|
198
|
+
else {
|
|
199
|
+
startHttp().catch((err) => {
|
|
200
|
+
console.error('Fatal:', err);
|
|
201
|
+
(0, performance_db_js_1.closeDb)();
|
|
202
|
+
process.exit(1);
|
|
203
|
+
});
|
|
204
|
+
}
|
|
81
205
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Hyperliquid adapter — implements ExchangeAdapter for the HL public API.
|
|
3
|
+
* Base URL: https://api.hyperliquid.xyz/info
|
|
4
|
+
* All requests are POST, no auth needed for read endpoints.
|
|
5
|
+
*/
|
|
6
|
+
import type { ExchangeAdapter, Candle, AssetContext, FundingData } from '../../types.js';
|
|
7
|
+
export declare class HyperliquidAdapter implements ExchangeAdapter {
|
|
8
|
+
getName(): string;
|
|
9
|
+
getCandles(coin: string, interval: string, startTime: number): Promise<Candle[]>;
|
|
10
|
+
getAssetContext(coin: string): Promise<AssetContext>;
|
|
11
|
+
getPredictedFundings(): Promise<FundingData[]>;
|
|
12
|
+
getCurrentPrice(coin: string): Promise<number | null>;
|
|
13
|
+
}
|
|
14
|
+
//# sourceMappingURL=hyperliquid.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hyperliquid.d.ts","sourceRoot":"","sources":["../../../src/lib/adapters/hyperliquid.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EACV,eAAe,EACf,MAAM,EACN,YAAY,EACZ,WAAW,EAIZ,MAAM,gBAAgB,CAAC;AA+BxB,qBAAa,kBAAmB,YAAW,eAAe;IACxD,OAAO,IAAI,MAAM;IAIX,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAehF,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAsBpD,oBAAoB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAY9C,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAQ5D"}
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.HyperliquidAdapter = void 0;
|
|
4
|
+
const BASE_URL = 'https://api.hyperliquid.xyz/info';
|
|
5
|
+
const TIMEOUT_MS = 3000;
|
|
6
|
+
const MAX_RETRIES = 1;
|
|
7
|
+
async function hlPost(body, retries = MAX_RETRIES) {
|
|
8
|
+
for (let attempt = 0; attempt <= retries; attempt++) {
|
|
9
|
+
const controller = new AbortController();
|
|
10
|
+
const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
|
|
11
|
+
try {
|
|
12
|
+
const res = await fetch(BASE_URL, {
|
|
13
|
+
method: 'POST',
|
|
14
|
+
headers: { 'Content-Type': 'application/json' },
|
|
15
|
+
body: JSON.stringify(body),
|
|
16
|
+
signal: controller.signal,
|
|
17
|
+
});
|
|
18
|
+
clearTimeout(timer);
|
|
19
|
+
if (!res.ok) {
|
|
20
|
+
throw new Error(`HL API ${res.status}: ${res.statusText}`);
|
|
21
|
+
}
|
|
22
|
+
return (await res.json());
|
|
23
|
+
}
|
|
24
|
+
catch (err) {
|
|
25
|
+
clearTimeout(timer);
|
|
26
|
+
if (attempt === retries)
|
|
27
|
+
throw err;
|
|
28
|
+
await new Promise(r => setTimeout(r, 500));
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
throw new Error('HL API: max retries exceeded');
|
|
32
|
+
}
|
|
33
|
+
class HyperliquidAdapter {
|
|
34
|
+
getName() {
|
|
35
|
+
return 'Hyperliquid';
|
|
36
|
+
}
|
|
37
|
+
async getCandles(coin, interval, startTime) {
|
|
38
|
+
const raw = await hlPost({
|
|
39
|
+
type: 'candleSnapshot',
|
|
40
|
+
req: { coin, interval, startTime },
|
|
41
|
+
});
|
|
42
|
+
return raw.map(c => ({
|
|
43
|
+
open: parseFloat(c.o),
|
|
44
|
+
high: parseFloat(c.h),
|
|
45
|
+
low: parseFloat(c.l),
|
|
46
|
+
close: parseFloat(c.c),
|
|
47
|
+
volume: parseFloat(c.v),
|
|
48
|
+
time: c.t,
|
|
49
|
+
}));
|
|
50
|
+
}
|
|
51
|
+
async getAssetContext(coin) {
|
|
52
|
+
const raw = await hlPost({
|
|
53
|
+
type: 'metaAndAssetCtxs',
|
|
54
|
+
});
|
|
55
|
+
const meta = raw[0];
|
|
56
|
+
const ctxs = raw[1];
|
|
57
|
+
const idx = meta.universe.findIndex(a => a.name === coin);
|
|
58
|
+
if (idx === -1) {
|
|
59
|
+
throw new Error(`${coin} not found on Hyperliquid`);
|
|
60
|
+
}
|
|
61
|
+
const ctx = ctxs[idx];
|
|
62
|
+
return {
|
|
63
|
+
coin,
|
|
64
|
+
funding: parseFloat(ctx.funding || '0'),
|
|
65
|
+
openInterest: parseFloat(ctx.openInterest || '0'),
|
|
66
|
+
prevDayPx: parseFloat(ctx.prevDayPx || '0'),
|
|
67
|
+
volume24h: parseFloat(ctx.dayNtlVlm || '0'),
|
|
68
|
+
oraclePx: parseFloat(ctx.oraclePx || '0'),
|
|
69
|
+
markPx: parseFloat(ctx.markPx || '0'),
|
|
70
|
+
};
|
|
71
|
+
}
|
|
72
|
+
async getPredictedFundings() {
|
|
73
|
+
const raw = await hlPost({ type: 'predictedFundings' });
|
|
74
|
+
return raw.map(entry => ({
|
|
75
|
+
coin: entry[0],
|
|
76
|
+
venues: (entry[1] || []).map(([venue, data]) => ({
|
|
77
|
+
venue,
|
|
78
|
+
fundingRate: parseFloat(data.fundingRate),
|
|
79
|
+
nextFundingTime: data.nextFundingTime,
|
|
80
|
+
})),
|
|
81
|
+
}));
|
|
82
|
+
}
|
|
83
|
+
async getCurrentPrice(coin) {
|
|
84
|
+
try {
|
|
85
|
+
const ctx = await this.getAssetContext(coin);
|
|
86
|
+
return ctx.oraclePx || ctx.markPx;
|
|
87
|
+
}
|
|
88
|
+
catch {
|
|
89
|
+
return null;
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
exports.HyperliquidAdapter = HyperliquidAdapter;
|
|
94
|
+
//# sourceMappingURL=hyperliquid.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hyperliquid.js","sourceRoot":"","sources":["../../../src/lib/adapters/hyperliquid.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Exchange adapter interface — all tools call through this,
|
|
3
|
+
* never raw API fetch calls. Enables future Binance/Bybit adapters.
|
|
4
|
+
*/
|
|
5
|
+
import type { ExchangeAdapter } from '../types.js';
|
|
6
|
+
export declare function getAdapter(): ExchangeAdapter;
|
|
7
|
+
export declare function setAdapter(adapter: ExchangeAdapter): void;
|
|
8
|
+
export type { ExchangeAdapter };
|
|
9
|
+
//# sourceMappingURL=exchange-adapter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"exchange-adapter.d.ts","sourceRoot":"","sources":["../../src/lib/exchange-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAKnD,wBAAgB,UAAU,IAAI,eAAe,CAK5C;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEzD;AAED,YAAY,EAAE,eAAe,EAAE,CAAC"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.getAdapter = getAdapter;
|
|
4
|
+
exports.setAdapter = setAdapter;
|
|
5
|
+
const hyperliquid_js_1 = require("./adapters/hyperliquid.js");
|
|
6
|
+
let defaultAdapter = null;
|
|
7
|
+
function getAdapter() {
|
|
8
|
+
if (!defaultAdapter) {
|
|
9
|
+
defaultAdapter = new hyperliquid_js_1.HyperliquidAdapter();
|
|
10
|
+
}
|
|
11
|
+
return defaultAdapter;
|
|
12
|
+
}
|
|
13
|
+
function setAdapter(adapter) {
|
|
14
|
+
defaultAdapter = adapter;
|
|
15
|
+
}
|
|
16
|
+
//# sourceMappingURL=exchange-adapter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"exchange-adapter.js","sourceRoot":"","sources":["../../src/lib/exchange-adapter.ts"],"names":[],"mappings":";;AASA,gCAKC;AAED,gCAEC;AAbD,8DAA+D;AAE/D,IAAI,cAAc,GAA2B,IAAI,CAAC;AAElD,SAAgB,UAAU;IACxB,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,cAAc,GAAG,IAAI,mCAAkB,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,SAAgB,UAAU,CAAC,OAAwB;IACjD,cAAc,GAAG,OAAO,CAAC;AAC3B,CAAC"}
|