@hskksk/mem-ai-mcp-server 0.1.0

package/dist/tools/notes/search-notes.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { BaseTool } from '../base-tool.js';
+const searchNotesSchema = z.object({
+    query: z.string().describe('Search query'),
+    limit: z.number().int().positive().max(100).optional().describe('Maximum number of results (max 100)'),
+    offset: z.number().int().nonnegative().optional().describe('Number of results to skip'),
+});
+/**
+ * Tool for searching notes
+ */
+export class SearchNotesTool extends BaseTool {
+    constructor(client) {
+        super('search_notes', 'Search across all notes in mem.ai.', searchNotesSchema, client);
+    }
+    async execute(params) {
+        const validated = params;
+        return this.client.searchNotes(validated);
+    }
+}
+//# sourceMappingURL=search-notes.js.map

package/dist/tools/notes/search-notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-notes.js","sourceRoot":"","sources":["../../../src/tools/notes/search-notes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3C,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACtG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;CACxF,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,MAAoB;QAC9B,KAAK,CACH,cAAc,EACd,oCAAoC,EACpC,iBAAiB,EACjB,MAAM,CACP,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,OAAO,CAAC,MAAe;QACrC,MAAM,SAAS,GAAG,MAA2C,CAAC;QAC9D,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/types/api.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Type definitions for mem.ai API requests and responses
+ */
+export interface MemItRequest {
+    input: string;
+    instructions?: string;
+    context?: string;
+    timestamp?: string;
+}
+export interface MemItResponse {
+    request_id: string;
+}
+export interface Note {
+    id: string;
+    title: string;
+    content: string;
+    collection_ids: string[];
+    created_at: string;
+    updated_at: string;
+}
+export interface CreateNoteRequest {
+    content: string;
+    id?: string;
+    collection_ids?: string[];
+    collection_titles?: string[];
+    created_at?: string;
+    updated_at?: string;
+}
+export interface CreateNoteResponse extends Note {
+    request_id: string;
+}
+export interface GetNoteResponse extends Note {
+}
+export interface DeleteNoteResponse {
+    success: boolean;
+}
+export interface ListNotesResponse {
+    notes: Note[];
+}
+export interface SearchNotesRequest {
+    query: string;
+    limit?: number;
+    offset?: number;
+}
+export interface SearchNotesResponse {
+    notes: Note[];
+    total: number;
+}
+export interface Collection {
+    id: string;
+    title: string;
+    description?: string;
+    note_count: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface CreateCollectionRequest {
+    title: string;
+    description?: string;
+}
+export interface CreateCollectionResponse extends Collection {
+    request_id: string;
+}
+export interface GetCollectionResponse extends Collection {
+}
+export interface DeleteCollectionResponse {
+    success: boolean;
+}
+export interface ListCollectionsResponse {
+    collections: Collection[];
+}
+export interface SearchCollectionsRequest {
+    query: string;
+    limit?: number;
+    offset?: number;
+}
+export interface SearchCollectionsResponse {
+    collections: Collection[];
+    total: number;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/types/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAmB,SAAQ,IAAI;IAC9C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAgB,SAAQ,IAAI;CAAG;AAEhD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAID,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAyB,SAAQ,UAAU;IAC1D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAsB,SAAQ,UAAU;CAAG;AAE5D,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/types/api.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for mem.ai API requests and responses
+ */
+export {};
+//# sourceMappingURL=api.js.map

package/dist/types/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/tools.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+/**
+ * Type definitions for MCP tools
+ */
+/**
+ * Base tool response content
+ */
+export interface ToolResponseContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * Base tool response
+ */
+export interface ToolResponse {
+    content: ToolResponseContent[];
+    isError?: boolean;
+}
+/**
+ * Tool definition for MCP server
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+/**
+ * Base tool interface
+ */
+export interface BaseTool {
+    name: string;
+    description: string;
+    schema: z.ZodType<unknown>;
+    handle(params: unknown): Promise<ToolResponse>;
+    toDefinition(): ToolDefinition;
+}
+//# sourceMappingURL=tools.d.ts.map

package/dist/types/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/types/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/C,YAAY,IAAI,cAAc,CAAC;CAChC"}

package/dist/types/tools.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tools.js.map

package/dist/types/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/types/tools.ts"],"names":[],"mappings":""}

package/dist/utils/error-handler.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Base error class for mem.ai API errors
+ */
+export declare class MemAPIError extends Error {
+    statusCode: number;
+    details?: unknown | undefined;
+    constructor(statusCode: number, message: string, details?: unknown | undefined);
+}
+/**
+ * Error for parameter validation failures
+ */
+export declare class ValidationError extends Error {
+    issues?: unknown | undefined;
+    constructor(message: string, issues?: unknown | undefined);
+}
+/**
+ * Error for authentication failures (401)
+ */
+export declare class AuthenticationError extends MemAPIError {
+    constructor(message?: string);
+}
+/**
+ * Error for resource not found (404)
+ */
+export declare class NotFoundError extends MemAPIError {
+    constructor(message?: string);
+}
+/**
+ * Error for rate limiting (429)
+ */
+export declare class RateLimitError extends MemAPIError {
+    retryAfter?: number | undefined;
+    constructor(message?: string, retryAfter?: number | undefined);
+}
+/**
+ * Error for server errors (500+)
+ */
+export declare class ServerError extends MemAPIError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/utils/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAE3B,UAAU,EAAE,MAAM;IAElB,OAAO,CAAC,EAAE,OAAO;gBAFjB,UAAU,EAAE,MAAM,EACzB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,OAAO,YAAA;CAM3B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACJ,MAAM,CAAC,EAAE,OAAO;gBAAxC,OAAO,EAAE,MAAM,EAAS,MAAM,CAAC,EAAE,OAAO,YAAA;CAKrD;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,OAAO,GAAE,MAA0B;CAIhD;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;gBAChC,OAAO,GAAE,MAA6B;CAInD;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAGpC,UAAU,CAAC,EAAE,MAAM;gBAD1B,OAAO,GAAE,MAA8B,EAChC,UAAU,CAAC,EAAE,MAAM,YAAA;CAK7B;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;gBAC9B,OAAO,GAAE,MAAgC;CAItD"}

package/dist/utils/error-handler.js

@@ -0,0 +1,65 @@
+/**
+ * Base error class for mem.ai API errors
+ */
+export class MemAPIError extends Error {
+    statusCode;
+    details;
+    constructor(statusCode, message, details) {
+        super(message);
+        this.statusCode = statusCode;
+        this.details = details;
+        this.name = 'MemAPIError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+/**
+ * Error for parameter validation failures
+ */
+export class ValidationError extends Error {
+    issues;
+    constructor(message, issues) {
+        super(message);
+        this.issues = issues;
+        this.name = 'ValidationError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+/**
+ * Error for authentication failures (401)
+ */
+export class AuthenticationError extends MemAPIError {
+    constructor(message = 'Invalid API key') {
+        super(401, message);
+        this.name = 'AuthenticationError';
+    }
+}
+/**
+ * Error for resource not found (404)
+ */
+export class NotFoundError extends MemAPIError {
+    constructor(message = 'Resource not found') {
+        super(404, message);
+        this.name = 'NotFoundError';
+    }
+}
+/**
+ * Error for rate limiting (429)
+ */
+export class RateLimitError extends MemAPIError {
+    retryAfter;
+    constructor(message = 'Rate limit exceeded', retryAfter) {
+        super(429, message);
+        this.retryAfter = retryAfter;
+        this.name = 'RateLimitError';
+    }
+}
+/**
+ * Error for server errors (500+)
+ */
+export class ServerError extends MemAPIError {
+    constructor(message = 'Internal server error') {
+        super(500, message);
+        this.name = 'ServerError';
+    }
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/utils/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAE3B;IAEA;IAHT,YACS,UAAkB,EACzB,OAAe,EACR,OAAiB;QAExB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,eAAU,GAAV,UAAU,CAAQ;QAElB,YAAO,GAAP,OAAO,CAAU;QAGxB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACJ;IAApC,YAAY,OAAe,EAAS,MAAgB;QAClD,KAAK,CAAC,OAAO,CAAC,CAAC;QADmB,WAAM,GAAN,MAAM,CAAU;QAElD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD,YAAY,UAAkB,iBAAiB;QAC7C,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C,YAAY,UAAkB,oBAAoB;QAChD,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,WAAW;IAGpC;IAFT,YACE,UAAkB,qBAAqB,EAChC,UAAmB;QAE1B,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAFb,eAAU,GAAV,UAAU,CAAS;QAG1B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C,YAAY,UAAkB,uBAAuB;QACnD,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@hskksk/mem-ai-mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for mem.ai API integration",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "mem-ai-mcp-server": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "test": "node --test --import tsx tests/**/*.test.ts",
+    "lint": "eslint src --ext .ts",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "pnpm run build && pnpm test",
+    "publish:npm": "npm publish --access public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "dotenv": "^16.4.7",
+    "zod": "^3.25.1",
+    "zod-to-json-schema": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "@typescript-eslint/eslint-plugin": "^8.20.0",
+    "@typescript-eslint/parser": "^8.20.0",
+    "eslint": "^9.18.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hskksk/mem-ai-mcp-server.git"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "mem-ai",
+    "ai",
+    "memory"
+  ],
+  "author": "hskksk",
+  "license": "MIT"
+}