@mentagen/mcp 0.1.0

package/dist/utils/ejson.js

@@ -0,0 +1,30 @@
+import { EJSON } from 'ejson2';
+/**
+ * Parse an EJSON value and convert EJSON types (like $date) to native JS types.
+ * Use this when receiving data from the Mentagen API.
+ */
+export function parseEJSON(value) {
+    return EJSON.fromJSONValue(value);
+}
+/**
+ * Format a date value (which may be an EJSON $date object) to ISO string.
+ */
+export function formatDate(value) {
+    if (!value)
+        return '';
+    const parsed = parseEJSON(value);
+    if (parsed instanceof Date) {
+        return parsed.toISOString();
+    }
+    if (typeof parsed === 'string') {
+        return new Date(parsed).toISOString();
+    }
+    return '';
+}
+/**
+ * Format a date value to short date string (YYYY-MM-DD).
+ */
+export function formatShortDate(value) {
+    const iso = formatDate(value);
+    return iso ? iso.split('T')[0] : '';
+}

package/dist/utils/errors.js

@@ -0,0 +1,16 @@
+/**
+ * Format error messages for AI consumption.
+ * Errors should be clear and actionable.
+ */
+export function formatError(error) {
+    if (error instanceof Error) {
+        if (error.message.includes('Not Authorized')) {
+            return 'Permission denied. Your token may not have access to this resource.';
+        }
+        if (error.message.includes('not found')) {
+            return `Resource not found. ${error.message}`;
+        }
+        return error.message;
+    }
+    return String(error);
+}

package/dist/utils/formatting.js

@@ -0,0 +1,15 @@
+export function formatSearchResults(hits) {
+    const results = hits.map(hit => ({
+        id: hit._id,
+        name: hit.name,
+        content: hit.content || null,
+        type: hit.type || 'text',
+        board: hit.board || null,
+        score: hit._rankingScore || 0,
+        updatedAt: hit.updatedAt ? new Date(hit.updatedAt).toISOString() : null,
+    }));
+    return {
+        results,
+        total: results.length,
+    };
+}

package/dist/utils/urls.js

@@ -0,0 +1,18 @@
+/**
+ * Get the app URL from the API URL.
+ * Locally, the API runs on port 8002 but the app runs on port 8000.
+ */
+export function getAppUrl(apiUrl) {
+    const url = apiUrl.replace(/\/$/, '');
+    // Local dev: API is on 8002, app is on 8000
+    if (url.includes('localhost:8002')) {
+        return url.replace(':8002', ':8000');
+    }
+    return url;
+}
+export function getBoardUrl(baseUrl, boardId) {
+    return `${getAppUrl(baseUrl)}/b/${boardId}`;
+}
+export function getNodeUrl(baseUrl, boardId, nodeId) {
+    return `${getAppUrl(baseUrl)}/b/${boardId}/n/${nodeId}`;
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@mentagen/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Mentagen knowledge base integration with Cursor",
+  "type": "module",
+  "bin": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "clean": "rm -rf dist",
+    "prebuild": "yarn clean",
+    "build": "tsc --project tsconfig.build.json",
+    "verify": "node scripts/verify-build.js",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "prepublishOnly": "yarn test && yarn build && yarn verify",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "mcp",
+    "mentagen",
+    "cursor",
+    "knowledge-base",
+    "ai"
+  ],
+  "license": "UNLICENSED",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "ejson2": "^1.1.0",
+    "papaparse": "^5.5.3",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "@types/papaparse": "^5.5.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "resolutions": {
+    "tar": "7.5.3"
+  }
+}