remnote-mcp-server 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,90 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic
+Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.2] - 2026-02-07
+
+### Added
+
+- Documentation of multi-agent limitations in README.md
+  - Explains 1:1:1 architecture constraint (one AI agent ↔ one server ↔ one RemNote connection)
+  - Details three architectural constraints: stdio point-to-point transport, single-client WebSocket, port binding
+  - Provides practical implications and alternative approaches for users needing multiple agents
+  - Notes planned migration to HTTP transport (SSE) which would enable multi-agent support
+- Comprehensive testing infrastructure with Vitest (95 tests)
+  - Unit tests for WebSocketServer, tools, schemas
+  - Coverage thresholds enforced (80% lines/functions/statements, 75% branches)
+- Code quality tools
+  - ESLint with TypeScript-specific rules
+  - Prettier for consistent code formatting
+  - `./code-quality.sh` script for unified quality checks
+- CI/CD integration
+  - GitHub Actions workflow running all quality checks on push/PR
+  - CI status badge in README
+- npm scripts for testing, linting, and formatting
+- Test helpers and mock implementations for isolated testing
+
+### Changed
+
+- MCP server version is now dynamically read from package.json instead of being hardcoded in src/index.ts
+
+## [0.1.1] - 2026-02-07
+
+### Added
+
+- README.md now includes explanation of stdio transport architecture and its implications (lifecycle management, message
+  protocol, logging constraints)
+- AGENTS.md now references `.agents/dev-documentation.md` for documentation guidelines
+- AGENTS.md now includes critical reminder to read `.agents/dev-workflow.md` before writing code or docs
+- README.md now includes inline verification step for `npm link` using `which` command with concise explanation of what
+  npm link creates
+- README.md now explains Node.js environment requirement for Claude Code CLI to execute the `remnote-mcp-server` command
+- LICENSE file (MIT License)
+- Repository, homepage, and bugs fields in package.json for npm registry
+- Files field in package.json to explicitly control published files
+- prepublishOnly script to ensure build before publishing
+- Additional keywords for improved npm discoverability
+- Coauthorship policy documented in CLAUDE.md
+- Publishing documentation in docs/publishing.md for maintainers
+
+### Fixed
+
+- Version mismatch between package.json (0.1.0) and MCP server declaration (was 1.0.0)
+- Corrected critical configuration error in all documentation files that would prevent users from successfully setting
+  up the server
+
+### Changed
+
+- **BREAKING**: Documentation now shows correct Claude Code configuration format using `~/.claude.json` with
+  `mcpServers` key instead of deprecated `~/.claude/.mcp.json` format
+- Completely rewrote README.md for better user experience with comprehensive installation, verification,
+  troubleshooting, and usage examples
+- Updated AGENTS.md with correct configuration format and deprecation notices
+- Updated IMPLEMENTATION.md with correct configuration examples
+
+### Removed
+
+- Deleted CLAUDE_CODE_CONFIG.md (content consolidated into README.md and AGENTS.md to eliminate redundancy)
+
+## [0.1.0] - 2026-02-06
+
+### Added
+
+- Initial release: RemNote MCP Server
+- WebSocket server for RemNote plugin bridge
+- MCP stdio transport for Claude Code integration
+- Six RemNote tools: create_note, search, read_note, update_note, append_journal, status
+- Request/response correlation with UUID tracking
+- 5-second request timeout handling
+- Heartbeat support (ping/pong)
+- Single-client connection model
+- Graceful shutdown handling (SIGINT/SIGTERM)
+- Zod schema validation for all tool parameters
+- TypeScript strict mode compilation
+- Development mode with hot reload
+- Global npm linking support

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nightingale7 nightingale7@gmail.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,506 @@
+# RemNote MCP Server
+
+[![CI](https://github.com/robert7/remnote-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/robert7/remnote-mcp-server/actions/workflows/ci.yml)
+
+MCP server that bridges Claude Code (and other MCP clients) to [RemNote](https://remnote.com/) via the [RemNote MCP
+Bridge plugin](https://github.com/robert7/remnote-mcp-bridge).
+
+## What is This?
+
+The RemNote MCP Server enables AI assistants like Claude Code to interact directly with your RemNote knowledge base
+through the Model Context Protocol (MCP). This allows you to create notes, search your knowledge base, update existing
+notes, and maintain your daily journal—all through conversational commands.
+
+**Architecture:**
+
+```text
+AI agent (e.g. Claude Code, MCP Client) ↔ MCP Server (stdio) ↔ WebSocket Server :3002 ↔ RemNote Plugin ↔ RemNote
+```
+
+The server acts as a bridge:
+
+- Communicates with Claude Code via stdio transport (MCP protocol)
+- Runs a WebSocket server (port 3002) that the RemNote browser plugin connects to
+- Translates MCP tool calls into RemNote API actions
+
+## Features
+
+- **Create Notes** - Create new notes with optional parent hierarchy and tags
+- **Search Knowledge Base** - Full-text search with configurable result limits
+- **Read Notes** - Retrieve note content with configurable child depth
+- **Update Notes** - Modify titles, append content, add/remove tags
+- **Journal Entries** - Append timestamped entries to daily documents
+- **Connection Status** - Check server and plugin connection health
+
+## Important Limitations
+
+**This MCP server enforces a strict 1:1:1 relationship:** one AI agent ↔ one MCP server instance ↔ one RemNote plugin
+connection.
+
+### Multi-Agent Constraints
+
+You **cannot** use multiple AI agents (e.g., two Claude Code sessions) with the same RemNote knowledge base
+simultaneously. Three architectural constraints prevent this:
+
+1. **stdio transport is point-to-point** - Each MCP server process communicates with exactly one AI agent via
+   stdin/stdout. The transport protocol doesn't support multiple clients.
+2. **WebSocket enforces single-client** - The server explicitly rejects multiple RemNote plugin connections. Only one
+   plugin instance can connect to port 3002 at a time (connection code: 1008).
+3. **Port binding conflict** - Multiple server instances attempting to use the default port 3002 will fail with
+   `EADDRINUSE`.
+
+### Practical Implications
+
+- **One agent at a time** - Close one Claude Code session before starting another if both need RemNote access
+- **No concurrent access** - Cannot have multiple AI assistants modifying your RemNote knowledge base simultaneously
+- **Separate workspaces don't help** - Even with different ports, only one plugin instance can connect to RemNote at a
+  time
+
+### Alternative Approach
+
+If you need multiple AI agents with separate note-taking systems, use separate RemNote accounts/workspaces and configure
+each with its own MCP server instance on different ports.
+
+### Future Plans
+
+**HTTP transport migration planned** - The single-agent limitation is a temporary architectural constraint. A future
+version will migrate from stdio transport to HTTP transport (SSE), which would allow multiple AI agents to connect
+to the same MCP server instance simultaneously. This would remove constraint #1 above while maintaining the existing
+WebSocket bridge to RemNote.
+
+## Prerequisites
+
+- **Node.js** >= 18.0.0
+- **RemNote app** with [RemNote MCP Bridge plugin](https://github.com/robert7/remnote-mcp-bridge) installed
+- **Claude Code CLI** installed and configured
+
+## Installation
+
+### 1. Install the MCP Server
+
+**From source (recommended for development):**
+
+```bash
+git clone https://github.com/robert7/remnote-mcp-server.git
+cd remnote-mcp-server
+npm install
+npm run build
+
+# Creates global symlink: makes remnote-mcp-server command available system-wide
+npm link
+
+# Verify it worked
+which remnote-mcp-server
+# Should output e.g.: /Users/<username>/.nvm/versions/node/<version>/bin/remnote-mcp-server
+```
+
+**What npm link does:** Creates a symbolic link from your global `node_modules` bin directory to this project's
+executable, allowing Claude Code to launch `remnote-mcp-server` from anywhere without publishing to npm.
+
+**Important:** Claude Code CLI must have access to the same Node.js environment where you ran `npm link`. If Claude Code
+uses a different Node.js version or environment (e.g., different shell PATH), it won't find the command. Ensure your
+shell configuration (`.bashrc`, `.zshrc`) properly exposes your Node.js environment.
+
+**About stdio transport**
+
+This MCP server uses [stdio transport](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#stdio),
+the preferred communication mechanism for MCP. In stdio transport, Claude Code launches the server as a subprocess and
+exchanges JSON-RPC messages via standard input/output streams.
+
+**Key characteristics:**
+
+- **Lifecycle management**: Claude Code automatically starts the server when it launches and stops it on exit. The
+  server is launched as a subprocess, not a standalone service.
+- **Message protocol**: Communication uses newline-delimited JSON-RPC messages on stdin (client → server) and stdout
+  (server → client). No HTTP/REST endpoints are exposed.
+- **Logging constraint**: stdout is reserved exclusively for MCP protocol messages. All logging must go to stderr, which
+  is why the codebase uses `console.error()` for logs.
+
+This architecture provides tight integration with Claude Code while maintaining process isolation and security
+boundaries. For technical details, see the [MCP
+specification](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports).
+
+### 2. Install RemNote MCP Bridge Plugin
+
+Install the [RemNote MCP Bridge plugin](https://github.com/robert7/remnote-mcp-bridge) in your RemNote app:
+
+1. Open RemNote
+2. Navigate to plugin installation (see plugin repository for instructions)
+3. Configure WebSocket URL: `ws://127.0.0.1:3002`
+4. Enable auto-reconnect
+
+### 3. Configure Claude Code CLI
+
+MCP servers are configured in `~/.claude.json` under the `mcpServers` key within project-specific sections.
+
+**Add to your `~/.claude.json`:**
+
+```json
+{
+  "projects": {
+    "/Users/username": {
+      "mcpServers": {
+        "remnote": {
+          "type": "stdio",
+          "command": "remnote-mcp-server",
+          "args": [],
+          "env": {
+            "REMNOTE_WS_PORT": "3002"
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+**Configuration Notes:**
+
+- **Global availability:** Use your home directory path (`/Users/username`) to make RemNote tools available in all
+  projects
+- **Project-specific:** Use a specific project path to limit availability to that project
+- **Multiple projects:** Add `mcpServers` configuration under each project path as needed
+
+**Example with multiple projects:**
+
+```json
+{
+  "projects": {
+    "/Users/username": {
+      "mcpServers": {
+        "remnote": {
+          "type": "stdio",
+          "command": "remnote-mcp-server",
+          "args": [],
+          "env": {
+            "REMNOTE_WS_PORT": "3002"
+          }
+        }
+      }
+    },
+    "/Users/username/Projects/my-project": {
+      "mcpServers": {
+        "remnote": {
+          "type": "stdio",
+          "command": "remnote-mcp-server",
+          "args": [],
+          "env": {
+            "REMNOTE_WS_PORT": "3002"
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+### 4. Restart Claude Code
+
+Restart Claude Code completely to load the MCP server configuration. The server will start automatically when Claude
+Code launches.
+
+## Verification
+
+### Check Server is Running
+
+After Claude Code restarts, verify the server started:
+
+```bash
+# Check process is running
+ps aux | grep remnote-mcp-server
+
+# Check WebSocket port is listening
+lsof -i :3002
+```
+
+You should see the `remnote-mcp-server` process running.
+
+### Check RemNote Plugin Connection
+
+Open RemNote with the MCP Bridge plugin installed. The plugin control panel should show:
+
+- **Status:** "Connected" (green)
+- **Server:** ws://127.0.0.1:3002
+- Connection timestamp
+
+### Test in Claude Code
+
+In any Claude Code session, try:
+
+```
+Use remnote_status to check the connection
+```
+
+Expected response:
+
+```json
+{
+  "connected": true,
+  "actionsProcessed": 0,
+  "pluginVersion": "1.1.0",
+  "timestamp": "2026-02-07T..."
+}
+```
+
+### Test RemNote Integration
+
+Try creating a note:
+
+```
+Create a RemNote note titled "MCP Test" with content "Testing the bridge"
+```
+
+This should use the `remnote_create_note` tool and create a new note in your RemNote knowledge base.
+
+## Available Tools
+
+| Tool | Description | Parameters |
+|------|-------------|------------|
+| `remnote_create_note` | Create a new note with optional parent and tags | `title`, `content`, `parentId`, `tags` |
+| `remnote_search` | Search knowledge base | `query`, `limit`, `includeContent` |
+| `remnote_read_note` | Read note by RemNote ID | `remId`, `depth` |
+| `remnote_update_note` | Update title, append content, or modify tags | `remId`, `title`, `appendContent`, `addTags`, `removeTags` |
+| `remnote_append_journal` | Append to today's daily document | `content`, `timestamp` |
+| `remnote_status` | Check connection status and statistics | _(no parameters)_ |
+
+## Example Usage
+
+### Conversational Commands
+
+Claude Code will automatically select the appropriate tool based on your natural language commands:
+
+**Create notes:**
+```
+Create a note about "Project Ideas" with content:
+- AI-powered note taking
+- Personal knowledge management
+```
+
+**Search:**
+```
+Search my RemNote for notes about "machine learning"
+```
+
+**Read specific notes:**
+```
+Read the note with ID abc123
+```
+
+**Update notes:**
+```
+Add a tag "important" to note abc123
+```
+
+**Journal entries:**
+```
+Add to my journal: "Completed the RemNote MCP integration"
+```
+
+**Check status:**
+```
+Check if RemNote is connected
+```
+
+## Configuration
+
+### Environment Variables
+
+- `REMNOTE_WS_PORT` - WebSocket server port (default: 3002)
+
+**Example with custom port:**
+
+```json
+{
+  "projects": {
+    "/Users/username": {
+      "mcpServers": {
+        "remnote": {
+          "type": "stdio",
+          "command": "remnote-mcp-server",
+          "args": [],
+          "env": {
+            "REMNOTE_WS_PORT": "3003"
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+**Note:** If you change the port, you must also update the WebSocket URL in the RemNote MCP Bridge plugin settings.
+
+### RemNote Plugin Settings
+
+Configure in the plugin control panel:
+
+- **WebSocket URL:** `ws://127.0.0.1:3002` (or your custom port)
+- **Auto-reconnect:** Enabled (recommended)
+
+## Troubleshooting
+
+### Server Not Starting
+
+1. **Check if globally linked:**
+   ```bash
+   which remnote-mcp-server
+   ```
+Should return a path to the executable.
+
+2. **Re-link if needed:**
+   ```bash
+   cd ~/Projects/_private/remnote-mcp-server
+   npm link
+   ```
+
+3. **Check Claude Code logs:**
+   ```bash
+   tail -f ~/.claude/debug/mcp-*.log
+   ```
+
+### Port 3002 Already in Use
+
+If you see "EADDRINUSE" error:
+
+```bash
+# Find what's using the port
+lsof -i :3002
+
+# Kill the process if needed
+kill -9 <PID>
+```
+
+Alternatively, configure a different port in both `~/.claude.json` and the RemNote plugin settings.
+
+### Plugin Won't Connect
+
+1. **Verify plugin settings in RemNote:**
+   - WebSocket URL: `ws://127.0.0.1:3002`
+   - Auto-reconnect: Enabled
+2. **Check plugin console (RemNote Developer Tools):**
+   ```
+   Cmd+Option+I (macOS)
+   Ctrl+Shift+I (Windows/Linux)
+   ```
+
+3. **Restart RemNote** after changing settings
+4. **Check server logs** for connection messages
+
+### Tools Not Appearing in Claude Code
+
+1. **Verify configuration in `~/.claude.json`:**
+   ```bash
+   cat ~/.claude.json | grep -A 10 mcpServers
+   ```
+
+2. **Ensure configuration is under correct project path** (use home directory for global)
+3. **Restart Claude Code completely** (not just reload)
+4. **Check MCP logs:**
+   ```bash
+   tail -f ~/.claude/debug/mcp-*.log
+   ```
+
+### Configuration Not Working
+
+**Common issue:** Using the old `~/.claude/.mcp.json` file format
+
+❌ **Old format (deprecated):**
+```json
+// File: ~/.claude/.mcp.json
+{
+  "remnote": { ... }
+}
+```
+
+✅ **Correct format:**
+```json
+// File: ~/.claude.json
+{
+  "projects": {
+    "/Users/username": {
+      "mcpServers": {
+        "remnote": { ... }
+      }
+    }
+  }
+}
+```
+
+The `enabledMcpjsonServers` setting in `~/.claude/settings.json` is also deprecated and no longer needed.
+
+## Development
+
+### Setup
+
+```bash
+npm install
+npm run build
+npm link  # Make command globally available
+```
+
+### Development Workflow
+
+```bash
+npm run dev          # Watch mode with hot reload
+npm run typecheck    # Type checking only
+npm run build        # Production build
+```
+
+### Testing
+
+```bash
+npm test             # Run all tests
+npm run test:watch   # Watch mode
+npm run test:coverage # With coverage report
+```
+
+### Code Quality
+
+```bash
+./code-quality.sh    # Run all checks
+npm run lint         # ESLint only
+npm run format       # Format code
+```
+
+### Before Committing
+
+Run `./code-quality.sh` to ensure all checks pass.
+
+### Manual Testing
+
+To test the server independently (without Claude Code):
+
+```bash
+# Stop Claude Code first to free port 3002
+cd ~/Projects/_private/remnote-mcp-server
+npm run dev
+```
+
+Expected output:
+```
+[WebSocket Server] Listening on port 3002
+[MCP Server] Server started on stdio
+```
+
+When the RemNote plugin connects:
+```
+[WebSocket Server] Client connected
+[RemNote Bridge] RemNote plugin connected
+```
+
+Press Ctrl+C to stop.
+
+### Development Documentation
+
+- **[IMPLEMENTATION.md](./IMPLEMENTATION.md)** - Technical implementation details
+- **[AGENTS.md](./AGENTS.md)** - AI agent and developer guidance
+- **[CHANGELOG.md](./CHANGELOG.md)** - Version history
+
+## Related Projects
+
+- [RemNote MCP Bridge Plugin](https://github.com/robert7/remnote-mcp-bridge) - Browser plugin for RemNote integration
+- [Model Context Protocol](https://modelcontextprotocol.io/) - Open protocol for AI-application integration
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createRequire } from 'module';
+import { WebSocketServer } from './websocket-server.js';
+import { registerAllTools } from './tools/index.js';
+const require = createRequire(import.meta.url);
+const packageJson = require('../package.json');
+const WS_PORT = parseInt(process.env.REMNOTE_WS_PORT || '3002', 10);
+async function main() {
+    // Initialize MCP server
+    const mcpServer = new Server({
+        name: 'remnote-mcp-server',
+        version: packageJson.version,
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Initialize WebSocket server for RemNote plugin
+    const wsServer = new WebSocketServer(WS_PORT);
+    // Log connection status to stderr (stdio reserved for MCP)
+    wsServer.onClientConnect(() => {
+        console.error('[RemNote Bridge] RemNote plugin connected');
+    });
+    wsServer.onClientDisconnect(() => {
+        console.error('[RemNote Bridge] RemNote plugin disconnected');
+    });
+    // Start WebSocket server
+    await wsServer.start();
+    console.error(`[WebSocket Server] Listening on port ${WS_PORT}`);
+    // Register all RemNote MCP tools
+    registerAllTools(mcpServer, wsServer);
+    // Set up stdio transport for MCP
+    const transport = new StdioServerTransport();
+    await mcpServer.connect(transport);
+    console.error('[MCP Server] Server started on stdio');
+    // Graceful shutdown
+    const shutdown = async () => {
+        console.error('[MCP Server] Shutting down...');
+        await wsServer.stop();
+        await mcpServer.close();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+main().catch((error) => {
+    console.error('[MCP Server] 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":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE/C,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;AAEpE,KAAK,UAAU,IAAI;IACjB,wBAAwB;IACxB,MAAM,SAAS,GAAG,IAAI,MAAM,CAC1B;QACE,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,WAAW,CAAC,OAAO;KAC7B,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IAEF,iDAAiD;IACjD,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;IAE9C,2DAA2D;IAC3D,QAAQ,CAAC,eAAe,CAAC,GAAG,EAAE;QAC5B,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,kBAAkB,CAAC,GAAG,EAAE;QAC/B,OAAO,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,yBAAyB;IACzB,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;IACvB,OAAO,CAAC,KAAK,CAAC,wCAAwC,OAAO,EAAE,CAAC,CAAC;IAEjE,iCAAiC;IACjC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEtC,iCAAiC;IACjC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEnC,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAEtD,oBAAoB;IACpB,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC/C,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/schemas/remnote-schemas.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+export declare const CreateNoteSchema: z.ZodObject<{
+    title: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    parentId: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const SearchSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    includeContent: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const ReadNoteSchema: z.ZodObject<{
+    remId: z.ZodString;
+    depth: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const UpdateNoteSchema: z.ZodObject<{
+    remId: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    appendContent: z.ZodOptional<z.ZodString>;
+    addTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    removeTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const AppendJournalSchema: z.ZodObject<{
+    content: z.ZodString;
+    timestamp: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;

package/dist/schemas/remnote-schemas.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export const CreateNoteSchema = z.object({
+    title: z.string().describe('The title of the note'),
+    content: z.string().optional().describe('Content as child bullets (newline-separated)'),
+    parentId: z.string().optional().describe('Parent Rem ID'),
+    tags: z.array(z.string()).optional().describe('Tags to apply'),
+});
+export const SearchSchema = z.object({
+    query: z.string().describe('Search query text'),
+    limit: z.number().int().min(1).max(100).default(20).describe('Maximum results'),
+    includeContent: z.boolean().default(false).describe('Include child content'),
+});
+export const ReadNoteSchema = z.object({
+    remId: z.string().describe('The Rem ID to read'),
+    depth: z.number().int().min(0).max(10).default(3).describe('Depth of children'),
+});
+export const UpdateNoteSchema = z.object({
+    remId: z.string().describe('The Rem ID to update'),
+    title: z.string().optional().describe('New title'),
+    appendContent: z.string().optional().describe('Content to append as children'),
+    addTags: z.array(z.string()).optional().describe('Tags to add'),
+    removeTags: z.array(z.string()).optional().describe('Tags to remove'),
+});
+export const AppendJournalSchema = z.object({
+    content: z.string().describe("Content to append to today's daily document"),
+    timestamp: z.boolean().default(true).describe('Include timestamp'),
+});
+//# sourceMappingURL=remnote-schemas.js.map

package/dist/schemas/remnote-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remnote-schemas.js","sourceRoot":"","sources":["../../src/schemas/remnote-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACnD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IACvF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;IACzD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;CAC/D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAC/E,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;CAC7E,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAChD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;CAChF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAClD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;IAClD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC9E,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;IAC/D,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;CACtE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAC3E,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;CACnE,CAAC,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,134 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { WebSocketServer } from '../websocket-server.js';
+export declare const CREATE_NOTE_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            title: {
+                type: string;
+                description: string;
+            };
+            content: {
+                type: string;
+                description: string;
+            };
+            parentId: {
+                type: string;
+                description: string;
+            };
+            tags: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const SEARCH_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            includeContent: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const READ_NOTE_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            remId: {
+                type: string;
+                description: string;
+            };
+            depth: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const UPDATE_NOTE_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            remId: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            appendContent: {
+                type: string;
+                description: string;
+            };
+            addTags: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            removeTags: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const APPEND_JOURNAL_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            content: {
+                type: string;
+                description: string;
+            };
+            timestamp: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const STATUS_TOOL: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+    };
+};
+export declare function registerAllTools(server: Server, wsServer: WebSocketServer): void;

package/dist/tools/index.js

@@ -0,0 +1,171 @@
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { CreateNoteSchema } from '../schemas/remnote-schemas.js';
+import { SearchSchema } from '../schemas/remnote-schemas.js';
+import { ReadNoteSchema } from '../schemas/remnote-schemas.js';
+import { UpdateNoteSchema } from '../schemas/remnote-schemas.js';
+import { AppendJournalSchema } from '../schemas/remnote-schemas.js';
+export const CREATE_NOTE_TOOL = {
+    name: 'remnote_create_note',
+    description: 'Create a new note in RemNote with optional content, parent, and tags',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            title: { type: 'string', description: 'The title of the note' },
+            content: { type: 'string', description: 'Content as child bullets (newline-separated)' },
+            parentId: { type: 'string', description: 'Parent Rem ID' },
+            tags: { type: 'array', items: { type: 'string' }, description: 'Tags to apply' },
+        },
+        required: ['title'],
+    },
+};
+export const SEARCH_TOOL = {
+    name: 'remnote_search',
+    description: 'Search the RemNote knowledge base for notes matching a query',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: { type: 'string', description: 'Search query text' },
+            limit: { type: 'number', description: 'Maximum results (1-100, default: 20)' },
+            includeContent: { type: 'boolean', description: 'Include child content (default: false)' },
+        },
+        required: ['query'],
+    },
+};
+export const READ_NOTE_TOOL = {
+    name: 'remnote_read_note',
+    description: 'Read a specific note from RemNote by its Rem ID',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            remId: { type: 'string', description: 'The Rem ID to read' },
+            depth: { type: 'number', description: 'Depth of children to include (0-10, default: 3)' },
+        },
+        required: ['remId'],
+    },
+};
+export const UPDATE_NOTE_TOOL = {
+    name: 'remnote_update_note',
+    description: 'Update an existing note in RemNote (change title, append content, or modify tags)',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            remId: { type: 'string', description: 'The Rem ID to update' },
+            title: { type: 'string', description: 'New title' },
+            appendContent: { type: 'string', description: 'Content to append as children' },
+            addTags: { type: 'array', items: { type: 'string' }, description: 'Tags to add' },
+            removeTags: { type: 'array', items: { type: 'string' }, description: 'Tags to remove' },
+        },
+        required: ['remId'],
+    },
+};
+export const APPEND_JOURNAL_TOOL = {
+    name: 'remnote_append_journal',
+    description: "Append content to today's daily document in RemNote",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            content: { type: 'string', description: "Content to append to today's daily document" },
+            timestamp: { type: 'boolean', description: 'Include timestamp (default: true)' },
+        },
+        required: ['content'],
+    },
+};
+export const STATUS_TOOL = {
+    name: 'remnote_status',
+    description: 'Check the connection status and statistics of the RemNote MCP bridge',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+    },
+};
+export function registerAllTools(server, wsServer) {
+    // Single CallTool handler for all tools
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        try {
+            switch (request.params.name) {
+                case 'remnote_create_note': {
+                    const args = CreateNoteSchema.parse(request.params.arguments);
+                    const result = await wsServer.sendRequest('create_note', args);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                    };
+                }
+                case 'remnote_search': {
+                    const args = SearchSchema.parse(request.params.arguments);
+                    const result = await wsServer.sendRequest('search', args);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                    };
+                }
+                case 'remnote_read_note': {
+                    const args = ReadNoteSchema.parse(request.params.arguments);
+                    const result = await wsServer.sendRequest('read_note', args);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                    };
+                }
+                case 'remnote_update_note': {
+                    const args = UpdateNoteSchema.parse(request.params.arguments);
+                    const result = await wsServer.sendRequest('update_note', args);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                    };
+                }
+                case 'remnote_append_journal': {
+                    const args = AppendJournalSchema.parse(request.params.arguments);
+                    const result = await wsServer.sendRequest('append_journal', args);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                    };
+                }
+                case 'remnote_status': {
+                    const connected = wsServer.isConnected();
+                    if (!connected) {
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify({ connected: false, message: 'RemNote plugin not connected' }, null, 2),
+                                },
+                            ],
+                        };
+                    }
+                    const result = await wsServer.sendRequest('status', {});
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({ connected: true, ...(typeof result === 'object' ? result : {}) }, null, 2),
+                            },
+                        ],
+                    };
+                }
+                default:
+                    throw new Error(`Unknown tool: ${request.params.name}`);
+            }
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Register list_tools handler
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [
+            CREATE_NOTE_TOOL,
+            SEARCH_TOOL,
+            READ_NOTE_TOOL,
+            UPDATE_NOTE_TOOL,
+            APPEND_JOURNAL_TOOL,
+            STATUS_TOOL,
+        ],
+    }));
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}

package/dist/types/bridge.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Request sent TO RemNote plugin
+ */
+export interface BridgeRequest {
+    id: string;
+    action: string;
+    payload: Record<string, unknown>;
+}
+/**
+ * Response received FROM RemNote plugin
+ */
+export interface BridgeResponse {
+    id: string;
+    result?: unknown;
+    error?: string;
+}
+/**
+ * Heartbeat messages
+ */
+export interface HeartbeatPing {
+    type: 'ping';
+}
+export interface HeartbeatPong {
+    type: 'pong';
+}
+export type BridgeMessage = BridgeRequest | BridgeResponse | HeartbeatPing | HeartbeatPong;

package/dist/types/bridge.js

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

package/dist/types/bridge.js.map

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

package/dist/websocket-server.d.ts

@@ -0,0 +1,16 @@
+export declare class WebSocketServer {
+    private wss;
+    private client;
+    private port;
+    private pendingRequests;
+    private connectCallbacks;
+    private disconnectCallbacks;
+    constructor(port: number);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    sendRequest(action: string, payload: Record<string, unknown>): Promise<unknown>;
+    isConnected(): boolean;
+    onClientConnect(callback: () => void): void;
+    onClientDisconnect(callback: () => void): void;
+    private handleMessage;
+}

package/dist/websocket-server.js

@@ -0,0 +1,143 @@
+import { WebSocketServer as WSServer, WebSocket } from 'ws';
+import { randomUUID } from 'crypto';
+export class WebSocketServer {
+    wss = null;
+    client = null;
+    port;
+    pendingRequests = new Map();
+    connectCallbacks = [];
+    disconnectCallbacks = [];
+    constructor(port) {
+        this.port = port;
+    }
+    async start() {
+        return new Promise((resolve, reject) => {
+            this.wss = new WSServer({ port: this.port }, () => {
+                resolve();
+            });
+            this.wss.on('error', (error) => {
+                console.error('[WebSocket Server] Error:', error);
+                reject(error);
+            });
+            this.wss.on('connection', (ws) => {
+                // Only allow single client connection
+                if (this.client && this.client.readyState === WebSocket.OPEN) {
+                    console.error('[WebSocket Server] Rejecting connection: client already connected');
+                    ws.close(1008, 'Only one client allowed');
+                    return;
+                }
+                this.client = ws;
+                console.error('[WebSocket Server] Client connected');
+                this.connectCallbacks.forEach((cb) => cb());
+                ws.on('message', (data) => {
+                    try {
+                        this.handleMessage(data.toString());
+                    }
+                    catch (error) {
+                        console.error('[WebSocket Server] Error handling message:', error);
+                    }
+                });
+                ws.on('close', () => {
+                    console.error('[WebSocket Server] Client disconnected');
+                    this.client = null;
+                    // Reject all pending requests
+                    for (const [_id, pending] of this.pendingRequests.entries()) {
+                        clearTimeout(pending.timeout);
+                        pending.reject(new Error('Connection lost'));
+                    }
+                    this.pendingRequests.clear();
+                    this.disconnectCallbacks.forEach((cb) => cb());
+                });
+                ws.on('error', (error) => {
+                    console.error('[WebSocket Server] Client error:', error);
+                });
+            });
+        });
+    }
+    async stop() {
+        return new Promise((resolve) => {
+            if (this.client) {
+                this.client.close();
+                this.client = null;
+            }
+            if (this.wss) {
+                this.wss.close(() => {
+                    this.wss = null;
+                    resolve();
+                });
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+    async sendRequest(action, payload) {
+        if (!this.client || this.client.readyState !== WebSocket.OPEN) {
+            throw new Error('RemNote plugin not connected. Please ensure the plugin is installed and running.');
+        }
+        const id = randomUUID();
+        const request = { id, action, payload };
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.pendingRequests.delete(id);
+                reject(new Error(`Request timeout: ${action}`));
+            }, 5000);
+            this.pendingRequests.set(id, { resolve, reject, timeout });
+            try {
+                this.client.send(JSON.stringify(request));
+            }
+            catch (error) {
+                clearTimeout(timeout);
+                this.pendingRequests.delete(id);
+                reject(error);
+            }
+        });
+    }
+    isConnected() {
+        return this.client !== null && this.client.readyState === WebSocket.OPEN;
+    }
+    onClientConnect(callback) {
+        this.connectCallbacks.push(callback);
+    }
+    onClientDisconnect(callback) {
+        this.disconnectCallbacks.push(callback);
+    }
+    handleMessage(data) {
+        try {
+            const message = JSON.parse(data);
+            // Handle pong response to ping
+            if ('type' in message && message.type === 'pong') {
+                return;
+            }
+            // Handle ping - respond with pong
+            if ('type' in message && message.type === 'ping') {
+                if (this.client && this.client.readyState === WebSocket.OPEN) {
+                    this.client.send(JSON.stringify({ type: 'pong' }));
+                }
+                return;
+            }
+            // Handle response to our request
+            if ('id' in message) {
+                const response = message;
+                const pending = this.pendingRequests.get(response.id);
+                if (pending) {
+                    clearTimeout(pending.timeout);
+                    this.pendingRequests.delete(response.id);
+                    if (response.error) {
+                        pending.reject(new Error(response.error));
+                    }
+                    else {
+                        pending.resolve(response.result);
+                    }
+                }
+                else {
+                    console.error('[WebSocket Server] Received response for unknown request ID:', response.id);
+                }
+            }
+        }
+        catch (error) {
+            console.error('[WebSocket Server] Error parsing message:', error);
+        }
+    }
+}
+//# sourceMappingURL=websocket-server.js.map

package/dist/websocket-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-server.js","sourceRoot":"","sources":["../src/websocket-server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "remnote-mcp-server",
+  "version": "0.1.2",
+  "description": "MCP server bridge for RemNote knowledge base",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "remnote-mcp-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:ui": "vitest --ui",
+    "lint": "eslint src test --ext .ts",
+    "lint:fix": "eslint src test --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
+    "quality": "./code-quality.sh",
+    "precommit": "./code-quality.sh"
+  },
+  "keywords": [
+    "mcp",
+    "remnote",
+    "model-context-protocol",
+    "knowledge-base",
+    "note-taking",
+    "ai",
+    "assistant",
+    "websocket",
+    "bridge"
+  ],
+  "author": "nightingale7 <nightingale7@gmail.com>",
+  "license": "MIT",
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/robert7/remnote-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/robert7/remnote-mcp-server/issues"
+  },
+  "homepage": "https://github.com/robert7/remnote-mcp-server#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "ws": "^8.19.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.1",
+    "@types/ws": "^8.18.1",
+    "@typescript-eslint/eslint-plugin": "^6.21.0",
+    "@typescript-eslint/parser": "^6.21.0",
+    "@vitest/coverage-v8": "^1.6.1",
+    "@vitest/ui": "^1.6.1",
+    "eslint": "^8.57.1",
+    "eslint-config-prettier": "^9.1.2",
+    "prettier": "^3.8.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^1.6.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}