aixx-mcp 1.0.2 → 1.0.4

package/README.md

@@ -0,0 +1,69 @@
+# @ AIXX MCP Server
+
+> **Google for AI — One line. Every AI model.**
+> A zero-dependency MCP server that lets any MCP-compatible client (WorkBuddy, Claude Desktop, Cursor, etc.) call **dozens of LLMs + image/video generation** through a single AIXX key.
+
+## What it does
+
+- 🔑 **One key, every model** — Claude, GPT, Gemini, DeepSeek, Qwen, GLM, Moonshot, MiniMax and more (38+ text models, live list).
+- 🖼️ **Image generation** — GPT-Image-2, Nano Banana Pro, Seedream, Midjourney, ...
+- 🎬 **Video generation** — MiniMax H3, Veo 3.1, Kling, Seedance, ... (async + task polling).
+- 🔌 **OpenAI-compatible** — talks to `https://baodan.run/v1`.
+- 🪶 **Zero dependencies** — single file, Node 18+ only.
+
+## Get a key
+
+Register at **https://baodan.run/console/** — new accounts get **¥5 free credit**. After login, generate your `sk-` key on the **令牌 (Tokens)** page.
+
+Your key looks like `sk-` + 16-128 alphanumeric characters.
+
+## Configure
+
+Set your key via the `AIXX_API_KEY` environment variable (recommended), or pass `apiKey` per call.
+
+### WorkBuddy
+
+Add to `~/.workbuddy/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "aixx": {
+      "command": "npx",
+      "args": ["-y", "aixx-mcp"],
+      "env": {
+        "AIXX_API_KEY": "sk-your-key-here"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop / Cursor
+
+Same block under `mcpServers` in your client's MCP config.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `aixx_list_models` | List live text models (cached 5 min). |
+| `aixx_chat` | Chat completion. Supports streaming internally, returns full text. |
+| `aixx_image` | Generate an image (sync ≤90s, then falls back to task). |
+| `aixx_video` | Submit a video generation task (async). |
+| `aixx_task` | Poll an image/video task for status/result URL. |
+
+### Tip: reasoning models
+
+Models like `deepseek-v4-pro` spend tokens on reasoning. Give `max_tokens` enough headroom (≥500) or the visible answer may be empty.
+
+## Billing
+
+- Text: token-based credit.
+- Images: from ¥0.06/image.
+- Video: per-second (e.g. MiniMax 480p ¥0.048/s); rate limit 5 req/min/key.
+- `402` means insufficient credit — top up at https://baodan.run/console/topup.
+
+## License
+
+MIT

package/index.js

@@ -11,13 +11,22 @@
  *   aixx_task          - 轮询媒体任务(GET /v1/media/task/{id})
  *
  * 鉴权: 优先用工具参数 apiKey,其次环境变量 AIXX_API_KEY。
- * Key 格式: sk- + 48位字母数字。
+ * Key 格式: sk- + 16-128位字母数字。
  */
 'use strict';
 
+const fs = require('fs');
+const path = require('path');
+
 const BASE_URL = process.env.AIXX_BASE_URL || 'https://baodan.run/v1';
 const ENV_KEY = process.env.AIXX_API_KEY || '';
 
+// 版本号从同目录 package.json 读取,避免与包版本脱节(npx 场景下包以目录形式存在,__dirname/package.json 必在)。
+let VERSION = 'unknown';
+try {
+  VERSION = JSON.parse(fs.readFileSync(path.join(__dirname, 'package.json'), 'utf8')).version || VERSION;
+} catch { /* 保持 fallback */ }
+
 let modelCache = null;
 let modelCacheAt = 0;
 const MODEL_TTL_MS = 5 * 60 * 1000;
@@ -138,7 +147,7 @@ async function handle(msg) {
       return reply(id, {
         protocolVersion: '2024-11-05',
         capabilities: { tools: {} },
-        serverInfo: { name: 'aixx-mcp', version: '1.0.1' }
+        serverInfo: { name: 'aixx-mcp', version: VERSION }
       });
     }
     if (method === 'notifications/initialized') return; // no response
@@ -158,8 +167,8 @@ async function callTool(id, params) {
   if (!key) {
     return toolResult(id, '缺少 AIXX API Key。请在连接器环境变量设置 AIXX_API_KEY,或在调用时传 apiKey 参数。注册并领取 Key: https://baodan.run/console/ (新用户送 ¥5,登录后在「令牌」页生成 sk- key)。', true);
   }
-  if (!/^sk-[A-Za-z0-9]{48}$/.test(key)) {
-    return toolResult(id, 'API Key 格式不对:应为 sk- + 48位字母数字。', true);
+  if (!/^sk-[A-Za-z0-9]{16,128}$/.test(key)) {
+    return toolResult(id, 'API Key 格式不对:应为 sk- + 16-128位字母数字(不要含连字符等符号)。', true);
   }
 
   try {

package/package.json

@@ -1,11 +1,56 @@
 {
   "name": "aixx-mcp",
-  "version": "1.0.2",
-  "description": "AIXX MCP Server - AI capability gateway (list models / chat / image / video / task)",
-  "type": "module",
-  "bin": { "aixx-mcp": "./index.js" },
-  "keywords": ["aixx", "mcp", "ai", "llm", "gateway"],
-  "author": "AIXX",
-  "license": "ISC",
-  "engines": { "node": ">=16" }
+  "version": "1.0.4",
+  "description": "AIXX MCP server — one API key to every AI model (Claude/GPT/Gemini/DeepSeek/Qwen/GLM) + image & video generation. Unified AI gateway, OpenAI-compatible. Works with any MCP client (CodeBuddy, Claude Code, Cursor, Cline).",
+  "type": "commonjs",
+  "main": "index.js",
+  "bin": {
+    "aixx-mcp": "index.js"
+  },
+  "files": [
+    "index.js",
+    "README.md"
+  ],
+  "keywords": [
+    "aixx",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "ai-gateway",
+    "llm-gateway",
+    "one-api",
+    "multi-model",
+    "openai",
+    "openai-compatible",
+    "openai-api",
+    "llm",
+    "ai",
+    "claude",
+    "claude-code",
+    "gpt",
+    "gemini",
+    "deepseek",
+    "qwen",
+    "glm",
+    "cursor",
+    "cline",
+    "codebuddy",
+    "image-generation",
+    "text-to-image",
+    "video-generation",
+    "text-to-video"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "AIXX",
+    "url": "https://baodan.run/aixx/"
+  },
+  "homepage": "https://baodan.run/aixx/",
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/kk0803/token-hub.git"
+  }
 }