@ainote/mcp 1.1.0 → 1.1.1

package/lib/tools/dev-doc-tools.js

@@ -1,12 +1,16 @@
 import { toSuccessContent } from './internal/formatters.js';
+import fs from 'fs';
+import path from 'path';
 
 function listDevDocsDefinition() {
   return {
     name: 'list_dev_docs',
-    description: `List dev documents under dev/ category hierarchy. Manage AI coding tool configs (CLAUDE.md, .cursorrules, etc.) and dev docs centrally.
+    description: `List your synced dev documents stored in AI Note cloud.
 
-Categories: claude, cursor, windsurf, copilot, docs, or custom subcategories.
-Supports markdown, json, yaml content types.`,
+Shows all documents under dev/ category including memory files, AI configs, and project docs.
+Use this to see what's synced and which files have local_path set for multi-device sync.
+
+Categories: memory, claude, cursor, windsurf, env, docs, or custom subcategories.`,
     inputSchema: {
       type: 'object',
       properties: {
@@ -47,9 +51,15 @@ function getDevDocDefinition() {
 function createDevDocDefinition() {
   return {
     name: 'create_dev_doc',
-    description: `Create a new dev document under dev/ category. Auto-creates subcategory if needed.
+    description: `Save a file to AI Note cloud for multi-device sync.
+
+PRIMARY USE CASES:
+- Memory files: ~/.claude/projects/.../memory/MEMORY.md
+- AI configs: CLAUDE.md, .cursorrules, .windsurfrules (not in git)
+- Project docs: architecture notes, planning docs
 
-Use this to store CLAUDE.md content, cursor rules, windsurf rules, API specs, architecture docs, etc.`,
+Set local_path to enable pull_dev_docs auto-sync on other devices.
+Categories: memory | claude | cursor | env | docs`,
     inputSchema: {
       type: 'object',
       properties: {
@@ -63,6 +73,10 @@ Use this to store CLAUDE.md content, cursor rules, windsurf rules, API specs, ar
           type: 'string',
           enum: ['markdown', 'json', 'yaml', 'text'],
           description: 'Content type. Auto-detected from title extension if omitted.'
+        },
+        local_path: {
+          type: 'string',
+          description: 'Absolute local file path for multi-device sync (e.g., ~/.claude/projects/.../MEMORY.md)'
         }
       },
       required: ['title', 'content']
@@ -85,6 +99,10 @@ function updateDevDocDefinition() {
           type: 'string',
           enum: ['replace', 'append', 'prepend'],
           description: 'Update mode (default: replace)'
+        },
+        local_path: {
+          type: 'string',
+          description: 'Update the local file path for multi-device sync'
         }
       },
       required: ['content']
@@ -107,6 +125,34 @@ function deleteDevDocDefinition() {
   };
 }
 
+function pullDevDocsDefinition() {
+  return {
+    name: 'pull_dev_docs',
+    description: `Restore all synced files to THIS device. Writes files to their local paths on disk.
+
+USE THIS WHEN:
+- Setting up a new machine (desktop, laptop)
+- Reinstalled macOS / fresh environment
+- Want to sync latest versions of memory/config files from cloud
+
+WHAT HAPPENS:
+1. Fetches all dev docs with local_path set
+2. Creates missing parent directories
+3. Writes content to each local_path on this machine
+
+Run once after installing ainote MCP on a new device to restore everything.`,
+    inputSchema: {
+      type: 'object',
+      properties: {
+        category: {
+          type: 'string',
+          description: 'Subcategory filter. Omit to pull all docs with local_path.'
+        }
+      }
+    }
+  };
+}
+
 function listDevCategoriesDefinition() {
   return {
     name: 'list_dev_categories',
@@ -155,6 +201,49 @@ export function getDevDocTools() {
         return result;
       }
     },
+    {
+      definition: pullDevDocsDefinition(),
+      handler: async (args, { apiClient }) => {
+        const result = await apiClient.callTool('pull_dev_docs', args);
+
+        // Extract docs from resource data and write to local paths
+        let written = [];
+        let skipped = [];
+        let errors = [];
+
+        try {
+          const resourceText = result?.content?.find(c => c.type === 'resource')?.resource?.text;
+          if (resourceText) {
+            const data = JSON.parse(resourceText);
+            for (const doc of data.docs || []) {
+              if (!doc.local_path || !doc.content) {
+                skipped.push(doc.title);
+                continue;
+              }
+              const expandedPath = doc.local_path.replace(/^~/, process.env.HOME || '');
+              try {
+                const dir = path.dirname(expandedPath);
+                fs.mkdirSync(dir, { recursive: true });
+                fs.writeFileSync(expandedPath, doc.content, 'utf8');
+                written.push(`✅ ${doc.title} → ${expandedPath}`);
+              } catch (e) {
+                errors.push(`❌ ${doc.title}: ${e.message}`);
+              }
+            }
+          }
+        } catch (e) {
+          errors.push(`Parse error: ${e.message}`);
+        }
+
+        const summary = [
+          written.length ? `Written (${written.length}):\n${written.join('\n')}` : null,
+          skipped.length ? `Skipped (no local_path): ${skipped.join(', ')}` : null,
+          errors.length ? `Errors:\n${errors.join('\n')}` : null,
+        ].filter(Boolean).join('\n\n');
+
+        return [{ type: 'text', text: summary || 'No docs with local_path found.' }];
+      }
+    },
     {
       definition: listDevCategoriesDefinition(),
       handler: async (_args, { apiClient }) => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ainote/mcp",
-  "version": "1.1.0",
-  "description": "MCP server for AI Note - Tasks + Dev Docs (CLAUDE.md, Cursor rules, Windsurf rules) management via MCP",
+  "version": "1.1.1",
+  "description": "MCP server for AI Note - Tasks, Dev Docs, and multi-device file sync (CLAUDE.md, memory files, Cursor rules, Windsurf rules)",
   "main": "index.js",
   "type": "module",
   "bin": {