asrai-mcp 0.4.5 → 0.5.0

package/README.md

@@ -1,22 +1,12 @@
 # asrai-mcp
 
-Crypto market analysis tools for AI agents, powered by the Asrai API.
-Pay-per-use via [x402](https://x402.org) — no subscriptions, no API keys.
+Crypto market analysis MCP server for Claude Desktop — pay-per-use via x402 on Base mainnet.
 
-> **Note:** This is the npx launcher for the [asrai-mcp Python package](https://pypi.org/project/asrai-mcp/).
-> It requires [uv](https://docs.astral.sh/uv/) to be installed on your system.
+**Zero install.** Just Node.js (already on your machine via npx).
 
-## Quick Start
+## Quick start
 
-```bash
-# Install uv (one time)
-curl -LsSf https://astral.sh/uv/install.sh | sh
-
-# Run via npx
-npx -y asrai-mcp
-```
-
-## Claude Desktop Config
+**Step 1** — Add to Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
 
 ```json
 {
@@ -24,21 +14,63 @@ npx -y asrai-mcp
     "asrai": {
       "command": "npx",
       "args": ["-y", "asrai-mcp"],
-      "env": { "PRIVATE_KEY": "0x<YOUR_PRIVATE_KEY>" }
+      "env": {
+        "PRIVATE_KEY": "0x<your_base_wallet_private_key>"
+      }
     }
   }
 }
 ```
 
-You need an Ethereum wallet funded with USDC on Base mainnet.
-Each request costs **$0.001 USDC**.
+**Step 2** — Restart Claude Desktop. Done.
+
+Each API call costs **$0.001 USDC** from your wallet on Base mainnet. Make sure your wallet has a small USDC balance (~$1–2 to start).
+
+## What you get
+
+15+ crypto analysis tools available directly in Claude:
+
+| Tool | What it does | Cost |
+|---|---|---|
+| `market_overview` | Trending, gainers/losers, RSI extremes | $0.004 |
+| `technical_analysis` | ALSAT, SuperALSAT, PSAR, MACD-DEMA, AlphaTrend | $0.007 |
+| `sentiment` | CBBI, CMC sentiment, AI insights | $0.003 |
+| `forecast` | AI 3-7 day price prediction | $0.001 |
+| `screener` | Find coins by criteria | $0.001 |
+| `smart_money` | Order blocks, FVGs, support/resistance | $0.002 |
+| `elliott_wave` | Elliott Wave analysis | $0.001 |
+| `ichimoku` | Ichimoku cloud | $0.001 |
+| `cashflow` | Capital flow data | $0.001 |
+| `coin_info` | Stats, info, price, tags | $0.004 |
+| `dexscreener` | DEX trading data | $0.001 |
+| `chain_tokens` | Low-cap tokens on chain | $0.001 |
+| `portfolio` | Portfolio analysis | $0.001 |
+| `channel_summary` | Latest crypto narratives | $0.001 |
+| `ask_ai` | AI analyst freeform answer | $0.002 |
+| `indicator_guide` | Asrai indicator reference | FREE |
+
+## Spend limit
 
-## Full Documentation
+Default session cap: **$2.00 USDC**. To change:
 
-See the main package: [github.com/abuzerasr/asrai-mcp](https://github.com/abuzerasr/asrai-mcp)
+```json
+"env": {
+  "PRIVATE_KEY": "0x...",
+  "ASRAI_MAX_SPEND": "5.0"
+}
+```
+
+## Alternative install (if you prefer)
+
+```bash
+# via uvx (requires uv)
+uvx asrai-mcp
+
+# via pip
+pip install asrai-mcp
+```
 
 ## Links
 
-- Website: [asrai.me](https://asrai.me)
-- Agents page: [asrai.me/agents](https://asrai.me/agents)
-- PyPI: [pypi.org/project/asrai-mcp](https://pypi.org/project/asrai-mcp/)
+- Homepage: https://asrai.me/agents
+- GitHub: https://github.com/abuzerasr/asrai-mcp

package/bin/asrai-mcp-server.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * Asrai MCP SSE Server — Docker / n8n mode.
+ * Usage: npx asrai-mcp-server
+ *        or via Docker (see docker-compose.yml)
+ */
+
+import { config } from "dotenv";
+import { homedir } from "os";
+import { join } from "path";
+import { startSseServer } from "../src/sse-server.js";
+
+config({ path: join(homedir(), ".env") });
+config();
+
+startSseServer();

package/bin/asrai-mcp.js

@@ -1,115 +1,26 @@
 #!/usr/bin/env node
 /**
- * asrai-mcp npm wrapper
- * Launches the Python asrai-mcp package via uvx (preferred) or pip-installed command.
- *
- * Usage via npx:
- *   npx -y asrai-mcp
- *
- * Usage in Claude Desktop config:
- *   { "command": "npx", "args": ["-y", "asrai-mcp"] }
+ * Asrai MCP server — pure Node.js, zero install required.
+ * Usage: npx -y asrai-mcp
  */
 
-const { spawnSync } = require('child_process');
-const os = require('os');
+import { config } from "dotenv";
+import { homedir } from "os";
+import { join } from "path";
+import { startStdio } from "../src/server.js";
 
-const args = process.argv.slice(2);
-const isWindows = os.platform() === 'win32';
+// Load ~/.env first, then cwd .env as fallback
+config({ path: join(homedir(), ".env") });
+config();
 
-// All messages go to stderr — stdout must stay clean for MCP JSON-RPC protocol
-function log(msg) {
-  process.stderr.write(msg + '\n');
+// Warn if no key set — one message, once
+if (!process.env.PRIVATE_KEY) {
+  process.stderr.write("[asrai-mcp] Warning: PRIVATE_KEY not set — x402 payments will fail.\n");
+  process.stderr.write("[asrai-mcp] Set it in your Claude Desktop config or ~/.env file.\n");
+  process.stderr.write("[asrai-mcp] See: https://github.com/abuzerasr/asrai-mcp\n");
 }
 
-function checkCommand(cmd) {
-  const check = spawnSync(
-    isWindows ? 'where' : 'which',
-    [cmd],
-    { stdio: 'ignore' }
-  );
-  return check.status === 0;
-}
-
-// ─── Check what's available ───────────────────────────────────────────────────
-
-const hasUvx = checkCommand('uvx');
-const hasUv  = checkCommand('uv');
-const hasPip = checkCommand('asrai-mcp');
-
-// ─── Nothing available ────────────────────────────────────────────────────────
-
-if (!hasUvx && !hasUv && !hasPip) {
-  log('');
-  log('asrai-mcp: Python is required but not found.');
-  log('');
-  log('Quick fix — install uv (Python package manager):');
-  if (isWindows) {
-    log('  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"');
-  } else {
-    log('  curl -LsSf https://astral.sh/uv/install.sh | sh');
-  }
-  log('  Then re-run: npx -y asrai-mcp');
-  log('');
-  log('Alternative — install via pip:');
-  log('  pip install asrai-mcp');
-  log('');
+startStdio().catch((err) => {
+  process.stderr.write(`[asrai-mcp] Fatal: ${err.message}\n`);
   process.exit(1);
-}
-
-// ─── Warn if no PRIVATE_KEY set (stdio mode only) ─────────────────────────────
-
-if (!process.env.PRIVATE_KEY && args.length === 0) {
-  log('[asrai-mcp] Warning: PRIVATE_KEY env var not set — x402 payments will fail.');
-  log('[asrai-mcp] Set it in your Claude Desktop config or .env file.');
-  log('[asrai-mcp] See: https://github.com/asrai-ai/asrai-mcp');
-  log('');
-}
-
-// ─── Try uvx ──────────────────────────────────────────────────────────────────
-
-if (hasUvx || hasUv) {
-  log('[asrai-mcp] Starting via uvx (downloads latest version if needed)...');
-
-  const result = spawnSync('uvx', ['asrai-mcp', ...args], {
-    stdio: ['inherit', 'inherit', 'inherit'],
-    env: process.env,
-  });
-
-  if (result.error) {
-    log('[asrai-mcp] uvx failed: ' + result.error.message);
-  } else if (result.status === 0) {
-    process.exit(0);
-  } else {
-    log('[asrai-mcp] uvx exited with code ' + result.status);
-  }
-
-  // If uvx failed but pip-installed version exists, fall through
-  if (!hasPip) {
-    log('');
-    log('[asrai-mcp] Failed to start. Try:');
-    log('  pip install asrai-mcp   # install manually');
-    log('  PRIVATE_KEY=0x...       # set your wallet key');
-    log('');
-    process.exit(result.status ?? 1);
-  }
-}
-
-// ─── Fall back to pip-installed asrai-mcp ────────────────────────────────────
-
-if (hasPip) {
-  log('[asrai-mcp] Starting (pip-installed)...');
-
-  const result = spawnSync('asrai-mcp', args, {
-    stdio: ['inherit', 'inherit', 'inherit'],
-    env: process.env,
-  });
-
-  if (result.error) {
-    log('[asrai-mcp] Error: ' + result.error.message);
-    process.exit(1);
-  }
-
-  process.exit(result.status ?? 1);
-}
-
-process.exit(1);
+});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "asrai-mcp",
-  "version": "0.4.5",
-  "description": "Asrai crypto analysis MCP server — pay-per-use via x402 on Base (npx wrapper for Python package)",
+  "version": "0.5.0",
+  "description": "Asrai crypto analysis MCP server — pay-per-use via x402 on Base. Zero install: just npx.",
   "keywords": ["mcp", "crypto", "asrai", "x402", "trading", "signals"],
   "homepage": "https://asrai.me/agents",
   "repository": {
@@ -9,14 +9,25 @@
     "url": "https://github.com/abuzerasr/asrai-mcp"
   },
   "license": "MIT",
+  "type": "module",
   "bin": {
-    "asrai-mcp": "./bin/asrai-mcp.js"
+    "asrai-mcp": "./bin/asrai-mcp.js",
+    "asrai-mcp-server": "./bin/asrai-mcp-server.js"
   },
   "files": [
     "bin/",
+    "src/",
     "README.md"
   ],
   "engines": {
     "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@x402/fetch": "^2.5.0",
+    "@x402/evm": "^2.5.0",
+    "viem": "^2.46.3",
+    "dotenv": "^16.0.0",
+    "express": "^4.21.0"
   }
 }