asrai-mcp-apikey 0.1.0

package/README.md

@@ -0,0 +1,76 @@
+# asrai-mcp-apikey
+
+Crypto market analysis MCP server for Claude Desktop — ADVANCED plan, no per-call payments.
+
+**Zero install.** Just Node.js (already on your machine via npx).
+
+## Quick start
+
+**Step 1** — Add to your Claude Desktop config:
+
+| OS | Config path |
+|---|---|
+| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
+| Linux | `~/.config/Claude/claude_desktop_config.json` |
+
+```json
+{
+  "mcpServers": {
+    "asrai": {
+      "command": "npx",
+      "args": ["-y", "asrai-mcp-apikey", "--key", "asr-<your_api_key>"]
+    }
+  }
+}
+```
+
+**Or** store your key in `~/.env` (loaded automatically — no `--key` arg needed):
+
+```
+ASRAI_KEY=asr-<your_api_key>
+```
+
+```json
+{
+  "mcpServers": {
+    "asrai": {
+      "command": "npx",
+      "args": ["-y", "asrai-mcp-apikey"]
+    }
+  }
+}
+```
+
+**Step 2** — Restart Claude Desktop. Done.
+
+Get your API key at [asrai.me/agents](https://asrai.me/agents). Requires an **ADVANCED plan** subscription or free trial (10 requests).
+
+## What you get
+
+15+ crypto analysis tools available directly in Claude:
+
+| Tool | What it does | Cost |
+|---|---|---|
+| `market_overview` | Trending, gainers/losers, RSI, screeners, sentiment, narratives, cashflow | $0.095 |
+| `technical_analysis` | ALSAT, SuperALSAT, PSAR, MACD-DEMA, AlphaTrend, TD, forecast, SMC, S/R, Elliott Wave, Ichimoku | $0.06 |
+| `sentiment` | CBBI, CMC sentiment, AI insights | $0.015 |
+| `forecast` | AI 3-7 day price prediction | $0.005 |
+| `screener` | Find coins by criteria | $0.005 |
+| `smart_money` | Order blocks, FVGs, support/resistance | $0.01 |
+| `elliott_wave` | Elliott Wave analysis | $0.005 |
+| `ichimoku` | Ichimoku cloud | $0.005 |
+| `cashflow` | Capital flow data | $0.005 |
+| `coin_info` | Stats, info, price, tags, CMC AI + auto DEX data | $0.025–$0.03 |
+| `dexscreener` | DEX trading data | $0.005 |
+| `chain_tokens` | Low-cap tokens on chain | $0.005 |
+| `portfolio` | Model portfolio — investment reference | $0.005 |
+| `channel_summary` | Latest crypto narratives | $0.005 |
+| `indicator_guide` | Asrai indicator reference | FREE |
+
+Costs shown reflect equivalent x402 value — included in your ADVANCED plan subscription.
+
+## Links
+
+- Homepage: https://asrai.me/agents
+- GitHub: https://github.com/abuzerasr/asrai-mcp-apikey

package/bin/asrai-mcp-apikey.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+/**
+ * Asrai MCP API Key — stdio bridge for Claude Desktop / npx users.
+ *
+ * Connects to the remote Asrai MCP server via HTTP Streamable and exposes
+ * it locally over stdio so Claude Desktop can use it without a remote URL.
+ *
+ * Usage:
+ *   npx -y asrai-mcp-apikey --key asr-<your_key>
+ *   ASRAI_KEY=asr-<your_key> npx -y asrai-mcp-apikey
+ *
+ * Claude Desktop config:
+ *   {
+ *     "mcpServers": {
+ *       "asrai": {
+ *         "command": "npx",
+ *         "args": ["-y", "asrai-mcp-apikey", "--key", "asr-<your_key>"]
+ *       }
+ *     }
+ *   }
+ */
+
+import { config } from "dotenv";
+import { homedir } from "os";
+import { join } from "path";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  ListToolsRequestSchema,
+  CallToolRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+// Load ~/.env first, then cwd .env as fallback (same pattern as asrai-mcp)
+config({ path: join(homedir(), ".env") });
+config();
+
+const REMOTE_BASE = "https://mcp-api.asrai.me";
+
+// ── API key resolution ────────────────────────────────────────────────────────
+
+function resolveKey() {
+  // --key asr-... flag
+  const flagIdx = process.argv.indexOf("--key");
+  if (flagIdx !== -1 && process.argv[flagIdx + 1]) {
+    return process.argv[flagIdx + 1].trim();
+  }
+  // ASRAI_KEY env var
+  if (process.env.ASRAI_KEY) return process.env.ASRAI_KEY.trim();
+
+  process.stderr.write(
+    "[asrai-mcp-apikey] ERROR: API key required.\n" +
+    "  Use: npx asrai-mcp-apikey --key asr-<your_key>\n" +
+    "  Or:  ASRAI_KEY=asr-<your_key> npx asrai-mcp-apikey\n"
+  );
+  process.exit(1);
+}
+
+// ── Bridge ───────────────────────────────────────────────────────────────────
+
+async function main() {
+  const key = resolveKey();
+  const remoteUrl = new URL(`${REMOTE_BASE}/mcp?key=${encodeURIComponent(key)}`);
+
+  // Connect to remote as MCP client
+  const remoteClient = new Client({ name: "asrai-bridge", version: "1.0.0" });
+  const remoteTransport = new StreamableHTTPClientTransport(remoteUrl);
+  await remoteClient.connect(remoteTransport);
+
+  // Expose locally as MCP server over stdio
+  const localServer = new Server(
+    { name: "asrai", version: "1.0.0" },
+    { capabilities: { tools: {} } }
+  );
+
+  localServer.setRequestHandler(ListToolsRequestSchema, async () => {
+    return await remoteClient.listTools();
+  });
+
+  localServer.setRequestHandler(CallToolRequestSchema, async (request) => {
+    return await remoteClient.callTool(request.params);
+  });
+
+  const stdio = new StdioServerTransport();
+  await localServer.connect(stdio);
+}
+
+main().catch((err) => {
+  process.stderr.write(`[asrai-mcp-apikey] Fatal: ${err.message}\n`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "asrai-mcp-apikey",
+  "version": "0.1.0",
+  "description": "Asrai crypto analysis MCP server — API key auth for ADVANCED plan users.",
+  "keywords": ["mcp", "crypto", "asrai", "trading", "signals", "apikey"],
+  "homepage": "https://asrai.me/agents",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/abuzerasr/asrai-mcp-apikey.git"
+  },
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "asrai-mcp-apikey": "./bin/asrai-mcp-apikey.js"
+  },
+  "files": [
+    "bin/asrai-mcp-apikey.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "dotenv": "^16.0.0"
+  },
+  "devDependencies": {
+    "express": "^4.21.0",
+    "pg": "^8.13.0"
+  }
+}