@chriscurrycc/memos-mcp 0.1.1 → 1.0.0

package/README.md

@@ -14,17 +14,18 @@ Enables AI assistants (Claude Code, Claude Desktop, Cursor, etc.) to read and wr
 - A running Memos instance
 - A Memos access token (Settings → Access Tokens)
 
-### Claude Code
+### Environment Variables
 
-```bash
-claude mcp add memos -- npx @chriscurrycc/memos-mcp
-```
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `MEMOS_URL` | Yes | Your Memos instance URL |
+| `MEMOS_TOKEN` | Yes | Memos access token |
+| `MEMOS_DEFAULT_VISIBILITY` | No | Default visibility for new memos (`PRIVATE`, `PROTECTED`, `PUBLIC`). Defaults to `PRIVATE` |
 
-Then set environment variables:
+### Claude Code
 
 ```bash
-export MEMOS_URL=https://your-memos-instance.com
-export MEMOS_TOKEN=your-access-token
+claude mcp add --scope user memos -e MEMOS_URL=https://your-memos-instance.com -e MEMOS_TOKEN=your-access-token -- npx -y @chriscurrycc/memos-mcp
 ```
 
 ### Claude Desktop
@@ -36,7 +37,7 @@ Add to your `claude_desktop_config.json`:
   "mcpServers": {
     "memos": {
       "command": "npx",
-      "args": ["-y", "memos-mcp"],
+      "args": ["-y", "@chriscurrycc/memos-mcp"],
       "env": {
         "MEMOS_URL": "https://your-memos-instance.com",
         "MEMOS_TOKEN": "your-access-token"
@@ -48,14 +49,30 @@ Add to your `claude_desktop_config.json`:
 
 ### With 1Password (recommended)
 
-Use `op run` to inject the token securely — no plaintext secrets on disk:
+Store your token securely in 1Password — no plaintext secrets on disk.
+
+1. Save the token to 1Password:
+
+```bash
+op item create --category=apiCredential --title="memos-api" token=your-access-token "valid from[date]=2026-01-01" "expires[date]=2026-02-01"
+```
+
+2. Configure with `op run` to inject the token at runtime:
+
+**Claude Code:**
+
+```bash
+claude mcp add --scope user memos -e MEMOS_URL=https://your-memos-instance.com -e MEMOS_TOKEN=op://Personal/memos-api/token -- op run --no-masking -- npx -y @chriscurrycc/memos-mcp
+```
+
+**Claude Desktop:**
 
 ```json
 {
   "mcpServers": {
     "memos": {
       "command": "op",
-      "args": ["run", "--", "npx", "-y", "memos-mcp"],
+      "args": ["run", "--no-masking", "--", "npx", "-y", "@chriscurrycc/memos-mcp"],
       "env": {
         "MEMOS_URL": "https://your-memos-instance.com",
         "MEMOS_TOKEN": "op://Personal/memos-api/token"
@@ -71,71 +88,54 @@ Use `op run` to inject the token securely — no plaintext secrets on disk:
 
 | Tool | Description |
 |------|-------------|
-| `list_memos` | List memos with filtering and pagination |
-| `get_memo` | Get a single memo by ID |
-| `search_memos` | Search memos by keyword |
-| `create_memo` | Create a new memo |
-| `update_memo` | Update content, visibility, pin, or archive state |
+| `list_memos` | Search and list memos with structured filters (keyword, tags, date range, visibility, pinned, content properties, etc.) |
+| `get_memo` | Get a single memo by numeric ID or UID string |
+| `create_memo` | Create a new memo with markdown content |
+| `update_memo` | Update content, visibility, pin, archive state, with optional `preserveUpdateTime` |
 | `delete_memo` | Permanently delete a memo |
 
-### Comments
-
-| Tool | Description |
-|------|-------------|
-| `list_memo_comments` | List comments on a memo |
-| `create_memo_comment` | Add a comment to a memo |
-
 ### Tags
 
 | Tool | Description |
 |------|-------------|
-| `list_pinned_tags` | List all pinned tags |
-| `list_tags_with_emoji` | List tags with their emojis |
-| `update_tag` | Update a tag's emoji or pinned status |
+| `list_tags` | List tags with usage counts, hierarchy support, and pinned/emoji metadata |
+| `update_tag` | Update a tag's pinned status or emoji |
+| `rename_tag` | Rename a tag across all memos |
 
 ### Resources
 
 | Tool | Description |
 |------|-------------|
 | `list_resources` | List all resources (attachments) |
-| `get_resource` | Get a resource by ID |
+| `upload_resource` | Upload a file (base64 encoded), with optional memo linking |
 | `delete_resource` | Delete a resource |
-| `link_resource_to_memo` | Link resources to a memo |
 
 ### Relations
 
 | Tool | Description |
 |------|-------------|
-| `list_memo_relations` | List memo relations |
-| `set_memo_relations` | Set relations (replaces all) |
-| `delete_memo_relation` | Remove a specific relation |
-
-### Reactions
-
-| Tool | Description |
-|------|-------------|
-| `list_reactions` | List reactions on a memo |
-| `upsert_reaction` | Add a reaction emoji |
-| `delete_reaction` | Remove a reaction |
+| `list_memo_relations` | List memo relations with recursive graph traversal (depth 1-5) |
+| `set_memo_relations` | Add or remove REFERENCE relations between memos |
 
-### Review (Spaced Repetition)
+### Review
 
 | Tool | Description |
 |------|-------------|
-| `list_review_memos` | Get memos due for review |
-| `get_random_memo` | Get a random memo |
-| `list_on_this_day_memos` | Memos created on this day in past years |
-| `get_time_travel_memos` | Memos from a random time period |
-| `record_review` | Record that memos have been reviewed |
-| `get_review_stats` | Get review statistics |
+| `get_review_memos` | Get today's spaced-repetition review batch |
+| `complete_review` | Mark the current review batch as completed |
+| `get_on_this_day_memos` | Get memos created on this day in previous years, grouped by year |
+| `update_review_setting` | Update review preferences (batch size, tag filters) |
 
 ## Prompts
 
 | Prompt | Description |
 |--------|-------------|
 | `capture` | Quick-save a thought as a memo |
-| `review` | Start a guided review session |
-| `daily_digest` | Summarize recent memo activity |
+| `review` | Start a guided spaced-repetition review session |
+| `on_this_day` | See memos from this day in previous years |
+| `digest` | Summarize memo activity for a time period (today/week/month) |
+| `tag_overview` | Review your tag system and organization |
+| `relation_graph` | Explore the relation graph starting from a memo |
 
 ## Resources
 

package/dist/prompts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,eAAO,MAAM,eAAe,GAAI,QAAQ,SAAS,SAoFhD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,eAAO,MAAM,eAAe,GAAI,QAAQ,SAAS,SA2KhD,CAAC"}

package/dist/prompts/index.js

@@ -1,9 +1,12 @@
 import { z } from "zod";
 export const registerPrompts = (server) => {
-    server.prompt("capture", "Quick-save a thought as a memo", {
-        content: z.string().describe("The thought or note to capture"),
-        tags: z.string().optional().describe("Comma-separated tags to add, e.g. 'idea,project'"),
-        visibility: z.enum(["PRIVATE", "PROTECTED", "PUBLIC"]).default("PRIVATE").describe("Memo visibility"),
+    server.registerPrompt("capture", {
+        description: "Quick-save a thought as a memo",
+        argsSchema: {
+            content: z.string().describe("The thought or note to capture"),
+            tags: z.string().optional().describe("Comma-separated tags to add, e.g. 'idea,project'"),
+            visibility: z.enum(["PRIVATE", "PROTECTED", "PUBLIC"]).default("PRIVATE").describe("Memo visibility"),
+        },
     }, ({ content, tags, visibility }) => {
         let memoContent = content;
         if (tags) {
@@ -25,46 +28,118 @@ export const registerPrompts = (server) => {
             ],
         };
     });
-    server.prompt("review", "Start a guided memo review session", {}, () => {
-        return {
-            messages: [
-                {
-                    role: "user",
-                    content: {
-                        type: "text",
-                        text: `Start a memo review session:
-1. Call list_review_memos to get memos due for review
-2. If the session is already completed, let me know
-3. Otherwise, present each memo one by one with its content
-4. After presenting all memos, ask if I want to record the review
-5. If yes, call record_review with the memo IDs and source REVIEW_SOURCE_REVIEW
-6. Finally, show the updated review stats using get_review_stats`,
-                    },
+    server.registerPrompt("review", {
+        description: "Start a spaced-repetition review session (间隔回顾)",
+    }, () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Start a memo review session:
+1. Call get_review_memos to get today's review batch
+2. If completed=true, let me know today's review is done and ask if I want to load a new batch (refresh=true)
+3. Otherwise, use get_memo to fetch full content for each memo and present them one by one
+4. After presenting all memos, call complete_review with the memo IDs to mark the batch as completed
+5. Congratulate me on completing the review`,
                 },
-            ],
+            },
+        ],
+    }));
+    server.registerPrompt("on_this_day", {
+        description: "See memos from this day in previous years (历史上的今天)",
+    }, () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Show me my "On This Day" memories:
+1. Call get_on_this_day_memos to get memos from this day in previous years
+2. Present them grouped by year, starting from the most recent
+3. For each memo, use get_memo to show the full content
+4. Add a brief reflection on how my thoughts or interests have evolved over the years`,
+                },
+            },
+        ],
+    }));
+    server.registerPrompt("digest", {
+        description: "Summarize memo activity for a time period",
+        argsSchema: {
+            period: z.enum(["today", "week", "month"]).default("week").describe("Time period to summarize"),
+        },
+    }, ({ period }) => {
+        const periodMap = {
+            today: { days: 1, label: "today" },
+            week: { days: 7, label: "the past week" },
+            month: { days: 30, label: "the past month" },
         };
-    });
-    server.prompt("daily_digest", "Summarize recent memo activity", {}, () => {
+        const { days, label } = periodMap[period];
         return {
             messages: [
                 {
                     role: "user",
                     content: {
                         type: "text",
-                        text: `Create a daily digest of my memos:
-1. Call list_memos with pageSize 50 to get recent memos
-2. Call list_pinned_tags to see my important tags
+                        text: `Create a digest of my memo activity for ${label}:
+1. Call list_memos with startDate set to ${days} days ago, pageSize=100 to get recent memos
+2. Call list_tags to see tag usage patterns
 3. Summarize:
-   - How many memos were created/updated recently
-   - Key themes and topics based on tags
+   - Total number of memos created/updated in this period
+   - Key themes and topics based on tags and content
    - Any pinned memos that might need attention
-   - Any memos with incomplete tasks (if visible in properties)
-4. Check list_on_this_day_memos for any "on this day" memories
-5. Present everything in a concise daily briefing format`,
+   - Any memos with incomplete tasks (call list_memos with hasIncompleteTasks=true)
+   - Trends or patterns you notice
+4. Present as a concise briefing`,
                     },
                 },
             ],
         };
     });
+    server.registerPrompt("tag_overview", {
+        description: "Review your tag system and organization",
+    }, () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Give me an overview of my tag system:
+1. Call list_tags to get all top-level tags with counts
+2. For tags with children (hasChildren=true), call list_tags with parent param to show the hierarchy
+3. Call list_tags with pinnedOnly=true to highlight my pinned tags
+4. Analyze and present:
+   - Tag hierarchy structure
+   - Most used vs rarely used tags
+   - Pinned tags and their usage
+   - Suggestions for cleanup (similar tags that could be merged, unused tags, etc.)`,
+                },
+            },
+        ],
+    }));
+    server.registerPrompt("relation_graph", {
+        description: "Explore the relation graph starting from a memo (关系图谱)",
+        argsSchema: {
+            memo: z.string().describe("Memo ID or UID to start from"),
+        },
+    }, ({ memo }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Explore the relation graph starting from memo ${memo}:
+1. Call get_memo to show the starting memo's content
+2. Call list_memo_relations with id="${memo}" and depth=5 to get the full relation graph
+3. For each connected memo, call get_memo to understand its content
+4. Present:
+   - A text-based visualization of the graph structure (which memos reference which)
+   - Brief summary of each connected memo
+   - The themes and topics that connect these memos
+   - Any interesting patterns or clusters in the graph`,
+                },
+            },
+        ],
+    }));
 };
 //# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAiB,EAAE,EAAE;IACnD,MAAM,CAAC,MAAM,CACX,SAAS,EACT,gCAAgC,EAChC;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAC9D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QACxF,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;KACtG,EACD,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE;QAChC,IAAI,WAAW,GAAG,OAAO,CAAC;QAC1B,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,OAAO,GAAG,IAAI;iBACjB,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;iBAC1B,IAAI,CAAC,GAAG,CAAC,CAAC;YACb,WAAW,GAAG,GAAG,WAAW,OAAO,OAAO,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,oFAAoF,UAAU,kBAAkB,WAAW,EAAE;qBACpI;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,QAAQ,EACR,oCAAoC,EACpC,EAAE,EACF,GAAG,EAAE;QACH,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;;;;;iEAM6C;qBACpD;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,cAAc,EACd,gCAAgC,EAChC,EAAE,EACF,GAAG,EAAE;QACH,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;;;;;;;;yDASqC;qBAC5C;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"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"}

package/dist/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,eAAO,MAAM,iBAAiB,GAAI,QAAQ,SAAS,EAAE,QAAQ,WAAW,SAuCvE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,eAAO,MAAM,iBAAiB,GAAI,QAAQ,SAAS,EAAE,QAAQ,WAAW,SAsCvE,CAAC"}

package/dist/resources/index.js

@@ -1,18 +1,17 @@
 export const registerResources = (server, client) => {
-    server.resource("memo", "memo://memos/{uid}", { description: "A memo by its UID", mimeType: "text/markdown" }, async (uri) => {
+    server.registerResource("memo", "memo://memos/{uid}", { description: "A memo by its UID", mimeType: "text/markdown" }, async (uri) => {
         const uid = uri.pathname.split("/").pop();
         if (!uid) {
             throw new Error("Invalid memo URI: missing UID");
         }
         const memo = await client.get(`/api/v1/memos:by-uid/${uid}`);
-        // Format as markdown with YAML frontmatter
+        const id = memo.name?.match(/^memos\/(\d+)$/)?.[1];
         const frontmatter = [
             "---",
+            id ? `id: ${id}` : null,
             `uid: ${memo.uid}`,
-            `name: ${memo.name}`,
-            `creator: ${memo.creator}`,
             `visibility: ${memo.visibility}`,
-            `pinned: ${memo.pinned}`,
+            memo.pinned ? `pinned: true` : null,
             `created: ${memo.createTime}`,
             `updated: ${memo.updateTime}`,
             memo.tags?.length ? `tags: [${memo.tags.join(", ")}]` : null,

package/dist/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAiB,EAAE,MAAmB,EAAE,EAAE;IAC1E,MAAM,CAAC,QAAQ,CACb,MAAM,EACN,oBAAoB,EACpB,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,eAAe,EAAE,EAC/D,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAO,wBAAwB,GAAG,EAAE,CAAC,CAAC;QAEnE,2CAA2C;QAC3C,MAAM,WAAW,GAAG;YAClB,KAAK;YACL,QAAQ,IAAI,CAAC,GAAG,EAAE;YAClB,SAAS,IAAI,CAAC,IAAI,EAAE;YACpB,YAAY,IAAI,CAAC,OAAO,EAAE;YAC1B,eAAe,IAAI,CAAC,UAAU,EAAE;YAChC,WAAW,IAAI,CAAC,MAAM,EAAE;YACxB,YAAY,IAAI,CAAC,UAAU,EAAE;YAC7B,YAAY,IAAI,CAAC,UAAU,EAAE;YAC7B,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;YAC5D,KAAK;SACN;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,eAAe;oBACzB,IAAI,EAAE,GAAG,WAAW,OAAO,IAAI,CAAC,OAAO,EAAE;iBAC1C;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAiB,EAAE,MAAmB,EAAE,EAAE;IAC1E,MAAM,CAAC,gBAAgB,CACrB,MAAM,EACN,oBAAoB,EACpB,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,eAAe,EAAE,EAC/D,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAO,wBAAwB,GAAG,EAAE,CAAC,CAAC;QAEnE,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,WAAW,GAAG;YAClB,KAAK;YACL,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI;YACvB,QAAQ,IAAI,CAAC,GAAG,EAAE;YAClB,eAAe,IAAI,CAAC,UAAU,EAAE;YAChC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI;YACnC,YAAY,IAAI,CAAC,UAAU,EAAE;YAC7B,YAAY,IAAI,CAAC,UAAU,EAAE;YAC7B,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;YAC5D,KAAK;SACN;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,eAAe;oBACzB,IAAI,EAAE,GAAG,WAAW,OAAO,IAAI,CAAC,OAAO,EAAE;iBAC1C;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYpE,eAAO,MAAM,YAAY,iBAoCxB,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAapE,eAAO,MAAM,YAAY,iBAqCxB,CAAC"}

package/dist/server.js

@@ -1,14 +1,13 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { MemosClient } from "./client.js";
 import { registerMemoTools } from "./tools/memos.js";
-import { registerCommentTools } from "./tools/comments.js";
 import { registerTagTools } from "./tools/tags.js";
 import { registerResourceTools } from "./tools/resources.js";
 import { registerRelationTools } from "./tools/relations.js";
-import { registerReactionTools } from "./tools/reactions.js";
 import { registerReviewTools } from "./tools/review.js";
 import { registerPrompts } from "./prompts/index.js";
 import { registerResources } from "./resources/index.js";
+const VALID_VISIBILITIES = ["PRIVATE", "PROTECTED", "PUBLIC"];
 export const createServer = () => {
     const memosUrl = process.env.MEMOS_URL;
     const memosToken = process.env.MEMOS_TOKEN;
@@ -20,22 +19,22 @@ export const createServer = () => {
         console.error("Error: MEMOS_TOKEN environment variable is required");
         process.exit(1);
     }
+    const rawVisibility = process.env.MEMOS_DEFAULT_VISIBILITY?.toUpperCase();
+    const defaultVisibility = rawVisibility && VALID_VISIBILITIES.includes(rawVisibility)
+        ? rawVisibility
+        : "PRIVATE";
     const client = new MemosClient(memosUrl, memosToken);
     const server = new McpServer({
         name: "memos-mcp",
-        version: "0.1.1",
+        version: "1.0.0",
     });
-    // Register all tools
-    registerMemoTools(server, client);
-    registerCommentTools(server, client);
+    registerMemoTools(server, client, { defaultVisibility });
     registerTagTools(server, client);
     registerResourceTools(server, client);
     registerRelationTools(server, client);
-    registerReactionTools(server, client);
     registerReviewTools(server, client);
-    // Register prompts
     registerPrompts(server);
-    // Register resources
+    // Register MCP resources
     registerResources(server, client);
     return server;
 };

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IACvC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAE3C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAErD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,qBAAqB;IACrB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEpC,mBAAmB;IACnB,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,qBAAqB;IACrB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,kBAAkB,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAU,CAAC;AAGvE,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IACvC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAE3C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,WAAW,EAAE,CAAC;IAC1E,MAAM,iBAAiB,GACrB,aAAa,IAAI,kBAAkB,CAAC,QAAQ,CAAC,aAA2B,CAAC;QACvE,CAAC,CAAE,aAA4B;QAC/B,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAErD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACzD,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,yBAAyB;IACzB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/tools/memos.d.ts

@@ -1,4 +1,9 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { MemosClient } from "../client.js";
-export declare const registerMemoTools: (server: McpServer, client: MemosClient) => void;
+type Visibility = "PRIVATE" | "PROTECTED" | "PUBLIC";
+interface MemoToolsOptions {
+    defaultVisibility: Visibility;
+}
+export declare const registerMemoTools: (server: McpServer, client: MemosClient, options: MemoToolsOptions) => void;
+export {};
 //# sourceMappingURL=memos.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"memos.d.ts","sourceRoot":"","sources":["../../src/tools/memos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,eAAO,MAAM,iBAAiB,GAAI,QAAQ,SAAS,EAAE,QAAQ,WAAW,SA0HvE,CAAC"}
+{"version":3,"file":"memos.d.ts","sourceRoot":"","sources":["../../src/tools/memos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAI3C,KAAK,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAsFrD,UAAU,gBAAgB;IACxB,iBAAiB,EAAE,UAAU,CAAC;CAC/B;AAED,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,SAAS,EACjB,QAAQ,WAAW,EACnB,SAAS,gBAAgB,SA+J1B,CAAC"}