@t0ken.ai/memoryx-mcp-server 2.0.0

package/README.md

@@ -0,0 +1,120 @@
+# MemoryX MCP Server
+
+MemoryX MCP Server 用于 Cursor、VS Code、Claude Desktop 等 MCP 客户端。
+
+## 功能
+
+- **save_memory**: 保存重要信息到记忆系统
+- **search_memory**: 搜索历史记忆
+- **get_account_info**: 获取账户信息
+
+## 特点
+
+- 本地 SQLite 队列存储
+- 按 conversation 分组批量发送
+- 自动重试机制
+- 离线支持
+
+## 安装
+
+### 方式一：NPM 安装
+
+```bash
+npm install -g @t0ken/memoryx-mcp-server
+```
+
+### 方式二：从源码安装
+
+```bash
+cd plugins/memoryx-mcp-server
+npm install
+npm run build
+npm link
+```
+
+## 配置
+
+### Cursor / VS Code
+
+在 `~/.cursor/mcp.json` 或 VS Code 的 MCP 配置中添加：
+
+```json
+{
+  "mcpServers": {
+    "memoryx": {
+      "command": "memoryx-mcp-server",
+      "env": {
+        "MEMORYX_API_KEY": "your_api_key_here",
+        "MEMORYX_URL": "https://t0ken.ai/api"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+在 Claude Desktop 配置文件中添加：
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "memoryx": {
+      "command": "memoryx-mcp-server",
+      "env": {
+        "MEMORYX_API_KEY": "your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+## 使用
+
+### 自动注册
+
+如果没有提供 API Key，MCP Server 会自动注册并生成一个。
+
+### 手动绑定
+
+1. 访问 https://t0ken.ai/portal
+2. 登录后复制 API Key
+3. 配置到环境变量 `MEMORYX_API_KEY`
+
+## 本地存储
+
+数据存储在 `~/.memoryx/mcp-server/` 目录：
+
+- `memoryx.db` - SQLite 数据库（消息队列）
+- `mcp-server.log` - 日志文件
+
+## 架构
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    MCP Server 架构                          │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  save_memory ──→ SQLite 本地队列 ──→ 定时批量发送 ──→ API   │
+│                                                             │
+│  ┌─────────────┐    ┌──────────────┐    ┌───────────────┐  │
+│  │ MCP Tools   │───→│ send_queue   │───→│ /conversations│  │
+│  │             │    │ 表           │    │ /flush        │  │
+│  └─────────────┘    └──────────────┘    └───────────────┘  │
+│                                                             │
+│  特点：                                                     │
+│  • 每条消息先存本地 SQLite                                   │
+│  • 按 conversation_id 分组                                  │
+│  • 2 轮对话后触发发送                                        │
+│  • 定时器每 5 秒检查队列                                     │
+│  • 失败重试最多 5 次                                        │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * MemoryX MCP Server - Model Context Protocol server for MemoryX
+ *
+ * Powered by @t0ken.ai/memoryx-sdk
+ *
+ * Features:
+ * - conversation preset (30k tokens / 5min idle)
+ * - Lazy SDK initialization
+ * - Automatic memory batching and retry
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG"}

package/dist/index.js

@@ -0,0 +1,300 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * MemoryX MCP Server - Model Context Protocol server for MemoryX
+ *
+ * Powered by @t0ken.ai/memoryx-sdk
+ *
+ * Features:
+ * - conversation preset (30k tokens / 5min idle)
+ * - Lazy SDK initialization
+ * - Automatic memory batching and retry
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const DEFAULT_API_BASE = "https://t0ken.ai/api";
+const PLUGIN_DIR = path.join(os.homedir(), ".memoryx", "mcp-server");
+// Lazy-loaded SDK instance
+let sdkInstance = null;
+let sdkInitPromise = null;
+function log(message) {
+    const timestamp = new Date().toISOString();
+    console.error(`[MemoryX MCP] ${timestamp} ${message}`);
+}
+async function getSDK() {
+    if (sdkInstance)
+        return sdkInstance;
+    if (sdkInitPromise)
+        return sdkInitPromise;
+    sdkInitPromise = (async () => {
+        // Dynamic import SDK
+        const { MemoryXSDK } = await Promise.resolve().then(() => __importStar(require("@t0ken.ai/memoryx-sdk")));
+        // Get env config
+        const envApiKey = process.env.MEMORYX_API_KEY || process.env.OPENMEMORYX_API_KEY;
+        const envApiUrl = process.env.MEMORYX_URL || process.env.OPENMEMORYX_URL;
+        // Use conversation preset: maxTokens: 30000, intervalMs: 300000 (5 min)
+        sdkInstance = new MemoryXSDK({
+            preset: 'conversation',
+            apiKey: envApiKey || undefined,
+            apiUrl: envApiUrl || DEFAULT_API_BASE,
+            autoRegister: !envApiKey,
+            agentType: 'mcp',
+            storageDir: PLUGIN_DIR
+        });
+        log("SDK initialized with conversation preset (30k tokens / 5min idle)");
+        return sdkInstance;
+    })();
+    return sdkInitPromise;
+}
+async function saveMemory(content, metadata = {}) {
+    if (!content || content.trim().length < 2) {
+        return { success: false, message: "Content too short", queued: 0 };
+    }
+    const skipPatterns = [
+        /^[好的ok谢谢嗯啊哈哈你好hihello拜拜再见]{1,5}$/i,
+        /^[？?！!。,，\s]{1,10}$/
+    ];
+    for (const pattern of skipPatterns) {
+        if (pattern.test(content.trim())) {
+            return { success: false, message: "Skipped: trivial content", queued: 0 };
+        }
+    }
+    try {
+        const sdk = await getSDK();
+        await sdk.addMemory(content.trim(), metadata);
+        const stats = await sdk.getQueueStats();
+        return {
+            success: true,
+            message: "Memory queued for processing",
+            queued: stats.messageCount
+        };
+    }
+    catch (e) {
+        log(`saveMemory failed: ${e}`);
+        return { success: false, message: String(e), queued: 0 };
+    }
+}
+async function searchMemory(query, limit = 5) {
+    if (!query || query.length < 2) {
+        return { memories: [], isLimited: false, remainingQuota: 0 };
+    }
+    try {
+        const sdk = await getSDK();
+        const result = await sdk.search(query, limit);
+        return {
+            memories: (result.data || []).map((m) => ({
+                id: m.id,
+                content: m.memory || m.content,
+                category: m.category || "other",
+                score: m.score || 0.5
+            })),
+            isLimited: false,
+            remainingQuota: result.remaining_quota ?? -1
+        };
+    }
+    catch (e) {
+        log(`searchMemory failed: ${e}`);
+        return { memories: [], isLimited: false, remainingQuota: 0 };
+    }
+}
+async function getAccountInfo() {
+    try {
+        const sdk = await getSDK();
+        const info = await sdk.getAccountInfo();
+        const stats = await sdk.getQueueStats();
+        return {
+            apiKey: info?.apiKey ? `${info.apiKey.slice(0, 8)}...` : null,
+            projectId: info?.projectId || "default",
+            userId: info?.userId || null,
+            queueLength: stats.messageCount
+        };
+    }
+    catch (e) {
+        log(`getAccountInfo failed: ${e}`);
+        return {
+            apiKey: null,
+            projectId: "default",
+            userId: null,
+            queueLength: 0
+        };
+    }
+}
+const server = new index_js_1.Server({
+    name: "memoryx-mcp-server",
+    version: "2.0.0",
+}, {
+    capabilities: {
+        tools: {},
+        resources: {},
+    },
+});
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "save_memory",
+                description: "保存重要信息到记忆系统。当用户提到偏好、习惯、项目信息、重要决定等值得记住的内容时调用。",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        content: {
+                            type: "string",
+                            description: "要记住的内容"
+                        },
+                        metadata: {
+                            type: "object",
+                            description: "可选的元数据，如分类、标签等"
+                        }
+                    },
+                    required: ["content"]
+                }
+            },
+            {
+                name: "search_memory",
+                description: "搜索历史记忆。在回答用户问题前调用，获取相关的记忆上下文。",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        query: {
+                            type: "string",
+                            description: "搜索关键词或问题"
+                        },
+                        limit: {
+                            type: "number",
+                            description: "返回结果数量，默认5",
+                            default: 5
+                        }
+                    },
+                    required: ["query"]
+                }
+            },
+            {
+                name: "get_account_info",
+                description: "获取当前 MemoryX 账户信息，包括 API Key、Project ID 和队列状态。",
+                inputSchema: {
+                    type: "object",
+                    properties: {}
+                }
+            }
+        ]
+    };
+});
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    switch (name) {
+        case "save_memory": {
+            const content = args?.content;
+            const metadata = args?.metadata || {};
+            const result = await saveMemory(content, metadata);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2)
+                    }
+                ]
+            };
+        }
+        case "search_memory": {
+            const query = args?.query;
+            const limit = args?.limit || 5;
+            const result = await searchMemory(query, limit);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2)
+                    }
+                ]
+            };
+        }
+        case "get_account_info": {
+            const result = await getAccountInfo();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2)
+                    }
+                ]
+            };
+        }
+        default:
+            throw new Error(`Unknown tool: ${name}`);
+    }
+});
+server.setRequestHandler(types_js_1.ListResourcesRequestSchema, async () => {
+    return {
+        resources: [
+            {
+                uri: "memoryx://status",
+                name: "MemoryX Status",
+                description: "当前 MemoryX 连接状态和队列信息",
+                mimeType: "application/json"
+            }
+        ]
+    };
+});
+server.setRequestHandler(types_js_1.ReadResourceRequestSchema, async (request) => {
+    const { uri } = request.params;
+    if (uri === "memoryx://status") {
+        const status = await getAccountInfo();
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: "application/json",
+                    text: JSON.stringify(status, null, 2)
+                }
+            ]
+        };
+    }
+    throw new Error(`Unknown resource: ${uri}`);
+});
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    log("MemoryX MCP Server v2.0.0 started (powered by SDK)");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAEA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,wEAAmE;AACnE,wEAAiF;AACjF,iEAK4C;AAC5C,2CAA6B;AAC7B,uCAAyB;AAEzB,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAChD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;AAErE,2BAA2B;AAC3B,IAAI,WAAW,GAAQ,IAAI,CAAC;AAC5B,IAAI,cAAc,GAAwB,IAAI,CAAC;AAE/C,SAAS,GAAG,CAAC,OAAe;IAC1B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,OAAO,CAAC,KAAK,CAAC,iBAAiB,SAAS,IAAI,OAAO,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,KAAK,UAAU,MAAM;IACnB,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IAEpC,IAAI,cAAc;QAAE,OAAO,cAAc,CAAC;IAE1C,cAAc,GAAG,CAAC,KAAK,IAAI,EAAE;QAC3B,qBAAqB;QACrB,MAAM,EAAE,UAAU,EAAE,GAAG,wDAAa,uBAAuB,GAAC,CAAC;QAE7D,iBAAiB;QACjB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACjF,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAEzE,wEAAwE;QACxE,WAAW,GAAG,IAAI,UAAU,CAAC;YAC3B,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,SAAS,IAAI,SAAS;YAC9B,MAAM,EAAE,SAAS,IAAI,gBAAgB;YACrC,YAAY,EAAE,CAAC,SAAS;YACxB,SAAS,EAAE,KAAK;YAChB,UAAU,EAAE,UAAU;SACvB,CAAC,CAAC;QAEH,GAAG,CAAC,mEAAmE,CAAC,CAAC;QACzE,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,OAAe,EAAE,WAAgC,EAAE;IAC3E,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACrE,CAAC;IAED,MAAM,YAAY,GAAG;QACnB,mCAAmC;QACnC,qBAAqB;KACtB,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACnC,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACjC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,0BAA0B,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,aAAa,EAAE,CAAC;QAExC,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,8BAA8B;YACvC,MAAM,EAAE,KAAK,CAAC,YAAY;SAC3B,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,GAAG,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;QAC/B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,KAAa,EAAE,QAAgB,CAAC;IAM1D,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;IAC/D,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAE9C,OAAO;YACL,QAAQ,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;gBAC7C,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,OAAO,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO;gBAC9B,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,OAAO;gBAC/B,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,GAAG;aACtB,CAAC,CAAC;YACH,SAAS,EAAE,KAAK;YAChB,cAAc,EAAE,MAAM,CAAC,eAAe,IAAI,CAAC,CAAC;SAC7C,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,GAAG,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC;QACjC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc;IAM3B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,cAAc,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,aAAa,EAAE,CAAC;QAExC,OAAO;YACL,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;YAC7D,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,SAAS;YACvC,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,IAAI;YAC5B,WAAW,EAAE,KAAK,CAAC,YAAY;SAChC,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,GAAG,CAAC,0BAA0B,CAAC,EAAE,CAAC,CAAC;QACnC,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,SAAS;YACpB,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,CAAC;SACf,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,iBAAM,CACvB;IACE,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;KACd;CACF,CACF,CAAC;AAEF,MAAM,CAAC,iBAAiB,CAAC,iCAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,OAAO;QACL,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,8CAA8C;gBAC3D,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,OAAO,EAAE;4BACP,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,QAAQ;yBACtB;wBACD,QAAQ,EAAE;4BACR,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,gBAAgB;yBAC9B;qBACF;oBACD,QAAQ,EAAE,CAAC,SAAS,CAAC;iBACtB;aACF;YACD;gBACE,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,+BAA+B;gBAC5C,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,UAAU;yBACxB;wBACD,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,YAAY;4BACzB,OAAO,EAAE,CAAC;yBACX;qBACF;oBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;iBACpB;aACF;YACD;gBACE,IAAI,EAAE,kBAAkB;gBACxB,WAAW,EAAE,gDAAgD;gBAC7D,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE;iBACf;aACF;SACF;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,iBAAiB,CAAC,gCAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,OAAO,GAAG,IAAI,EAAE,OAAiB,CAAC;YACxC,MAAM,QAAQ,GAAG,IAAI,EAAE,QAA+B,IAAI,EAAE,CAAC;YAC7D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACnD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;QAED,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,KAAK,GAAG,IAAI,EAAE,KAAe,CAAC;YACpC,MAAM,KAAK,GAAI,IAAI,EAAE,KAAgB,IAAI,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAChD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;QAED,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;YACtC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,iBAAiB,CAAC,qCAA0B,EAAE,KAAK,IAAI,EAAE;IAC9D,OAAO;QACL,SAAS,EAAE;YACT;gBACE,GAAG,EAAE,kBAAkB;gBACvB,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EAAE,sBAAsB;gBACnC,QAAQ,EAAE,kBAAkB;aAC7B;SACF;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,iBAAiB,CAAC,oCAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IACpE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAE/B,IAAI,GAAG,KAAK,kBAAkB,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;QACtC,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG;oBACH,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,GAAG,CAAC,oDAAoD,CAAC,CAAC;AAC5D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@t0ken.ai/memoryx-mcp-server",
+  "version": "2.0.0",
+  "description": "MemoryX MCP Server for Cursor/VS Code/Claude Desktop (powered by @t0ken.ai/memoryx-sdk)",
+  "main": "dist/index.js",
+  "bin": {
+    "memoryx-mcp-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts"
+  },
+  "keywords": [
+    "mcp",
+    "memory",
+    "ai",
+    "llm",
+    "cursor",
+    "vscode"
+  ],
+  "author": "MemoryX Team",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@t0ken.ai/memoryx-sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "ts-node": "^10.9.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/t0ken-ai/MemoryX.git",
+    "directory": "plugins/memoryx-mcp-server"
+  }
+}

package/src/index.ts

@@ -0,0 +1,313 @@
+#!/usr/bin/env node
+
+/**
+ * MemoryX MCP Server - Model Context Protocol server for MemoryX
+ * 
+ * Powered by @t0ken.ai/memoryx-sdk
+ * 
+ * Features:
+ * - conversation preset (30k tokens / 5min idle)
+ * - Lazy SDK initialization
+ * - Automatic memory batching and retry
+ */
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+  ListResourcesRequestSchema,
+  ReadResourceRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import * as path from "path";
+import * as os from "os";
+
+const DEFAULT_API_BASE = "https://t0ken.ai/api";
+const PLUGIN_DIR = path.join(os.homedir(), ".memoryx", "mcp-server");
+
+// Lazy-loaded SDK instance
+let sdkInstance: any = null;
+let sdkInitPromise: Promise<any> | null = null;
+
+function log(message: string): void {
+  const timestamp = new Date().toISOString();
+  console.error(`[MemoryX MCP] ${timestamp} ${message}`);
+}
+
+async function getSDK(): Promise<any> {
+  if (sdkInstance) return sdkInstance;
+  
+  if (sdkInitPromise) return sdkInitPromise;
+  
+  sdkInitPromise = (async () => {
+    // Dynamic import SDK
+    const { MemoryXSDK } = await import("@t0ken.ai/memoryx-sdk");
+    
+    // Get env config
+    const envApiKey = process.env.MEMORYX_API_KEY || process.env.OPENMEMORYX_API_KEY;
+    const envApiUrl = process.env.MEMORYX_URL || process.env.OPENMEMORYX_URL;
+    
+    // Use conversation preset: maxTokens: 30000, intervalMs: 300000 (5 min)
+    sdkInstance = new MemoryXSDK({
+      preset: 'conversation',
+      apiKey: envApiKey || undefined,
+      apiUrl: envApiUrl || DEFAULT_API_BASE,
+      autoRegister: !envApiKey,
+      agentType: 'mcp',
+      storageDir: PLUGIN_DIR
+    });
+    
+    log("SDK initialized with conversation preset (30k tokens / 5min idle)");
+    return sdkInstance;
+  })();
+  
+  return sdkInitPromise;
+}
+
+async function saveMemory(content: string, metadata: Record<string, any> = {}): Promise<{ success: boolean; message: string; queued: number }> {
+  if (!content || content.trim().length < 2) {
+    return { success: false, message: "Content too short", queued: 0 };
+  }
+  
+  const skipPatterns = [
+    /^[好的ok谢谢嗯啊哈哈你好hihello拜拜再见]{1,5}$/i,
+    /^[？?！!。,，\s]{1,10}$/
+  ];
+  
+  for (const pattern of skipPatterns) {
+    if (pattern.test(content.trim())) {
+      return { success: false, message: "Skipped: trivial content", queued: 0 };
+    }
+  }
+  
+  try {
+    const sdk = await getSDK();
+    await sdk.addMemory(content.trim(), metadata);
+    const stats = await sdk.getQueueStats();
+    
+    return { 
+      success: true, 
+      message: "Memory queued for processing", 
+      queued: stats.messageCount 
+    };
+  } catch (e) {
+    log(`saveMemory failed: ${e}`);
+    return { success: false, message: String(e), queued: 0 };
+  }
+}
+
+async function searchMemory(query: string, limit: number = 5): Promise<{
+  memories: any[];
+  isLimited: boolean;
+  remainingQuota: number;
+  upgradeHint?: string;
+}> {
+  if (!query || query.length < 2) {
+    return { memories: [], isLimited: false, remainingQuota: 0 };
+  }
+  
+  try {
+    const sdk = await getSDK();
+    const result = await sdk.search(query, limit);
+    
+    return {
+      memories: (result.data || []).map((m: any) => ({
+        id: m.id,
+        content: m.memory || m.content,
+        category: m.category || "other",
+        score: m.score || 0.5
+      })),
+      isLimited: false,
+      remainingQuota: result.remaining_quota ?? -1
+    };
+  } catch (e) {
+    log(`searchMemory failed: ${e}`);
+    return { memories: [], isLimited: false, remainingQuota: 0 };
+  }
+}
+
+async function getAccountInfo(): Promise<{
+  apiKey: string | null;
+  projectId: string;
+  userId: string | null;
+  queueLength: number;
+}> {
+  try {
+    const sdk = await getSDK();
+    const info = await sdk.getAccountInfo();
+    const stats = await sdk.getQueueStats();
+    
+    return {
+      apiKey: info?.apiKey ? `${info.apiKey.slice(0, 8)}...` : null,
+      projectId: info?.projectId || "default",
+      userId: info?.userId || null,
+      queueLength: stats.messageCount
+    };
+  } catch (e) {
+    log(`getAccountInfo failed: ${e}`);
+    return {
+      apiKey: null,
+      projectId: "default",
+      userId: null,
+      queueLength: 0
+    };
+  }
+}
+
+const server = new Server(
+  {
+    name: "memoryx-mcp-server",
+    version: "2.0.0",
+  },
+  {
+    capabilities: {
+      tools: {},
+      resources: {},
+    },
+  }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      {
+        name: "save_memory",
+        description: "保存重要信息到记忆系统。当用户提到偏好、习惯、项目信息、重要决定等值得记住的内容时调用。",
+        inputSchema: {
+          type: "object",
+          properties: {
+            content: {
+              type: "string",
+              description: "要记住的内容"
+            },
+            metadata: {
+              type: "object",
+              description: "可选的元数据，如分类、标签等"
+            }
+          },
+          required: ["content"]
+        }
+      },
+      {
+        name: "search_memory",
+        description: "搜索历史记忆。在回答用户问题前调用，获取相关的记忆上下文。",
+        inputSchema: {
+          type: "object",
+          properties: {
+            query: {
+              type: "string",
+              description: "搜索关键词或问题"
+            },
+            limit: {
+              type: "number",
+              description: "返回结果数量，默认5",
+              default: 5
+            }
+          },
+          required: ["query"]
+        }
+      },
+      {
+        name: "get_account_info",
+        description: "获取当前 MemoryX 账户信息，包括 API Key、Project ID 和队列状态。",
+        inputSchema: {
+          type: "object",
+          properties: {}
+        }
+      }
+    ]
+  };
+});
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+  
+  switch (name) {
+    case "save_memory": {
+      const content = args?.content as string;
+      const metadata = args?.metadata as Record<string, any> || {};
+      const result = await saveMemory(content, metadata);
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+    
+    case "search_memory": {
+      const query = args?.query as string;
+      const limit = (args?.limit as number) || 5;
+      const result = await searchMemory(query, limit);
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+    
+    case "get_account_info": {
+      const result = await getAccountInfo();
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    }
+    
+    default:
+      throw new Error(`Unknown tool: ${name}`);
+  }
+});
+
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+  return {
+    resources: [
+      {
+        uri: "memoryx://status",
+        name: "MemoryX Status",
+        description: "当前 MemoryX 连接状态和队列信息",
+        mimeType: "application/json"
+      }
+    ]
+  };
+});
+
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+  const { uri } = request.params;
+  
+  if (uri === "memoryx://status") {
+    const status = await getAccountInfo();
+    return {
+      contents: [
+        {
+          uri,
+          mimeType: "application/json",
+          text: JSON.stringify(status, null, 2)
+        }
+      ]
+    };
+  }
+  
+  throw new Error(`Unknown resource: ${uri}`);
+});
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  
+  log("MemoryX MCP Server v2.0.0 started (powered by SDK)");
+}
+
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "commonjs",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}