isolated-commands

This MCP server is a TypeScript-based Model Context Protocol (MCP) server that implements a simple, local, isolated notes system. It exposes resources representing plain text notes accessible via note:// URIs, a tool called create_note to add new notes, and a prompt summarize_notes that generates a structured summary of all stored notes for use in an LLM workflow. The server demonstrates core MCP concepts: resources with metadata, tooling to mutate server state, and prompts that produce structured data for downstream processing. To use it, run the server and connect your MCP client or Claude-like tooling to the stdio interface. You can create notes with the create_note tool, retrieve and enumerate notes via their note:// URIs, and invoke summarize_notes to obtain a consolidated summary that embeds all notes as resources for richer context in an LLM session.

Prerequisites:

• Node.js (recommended LTS) and npm installed
• Basic familiarity with running npm scripts

Install and build:

1. Install dependencies npm install

2. Build the server npm run build

3. (Optional) Run in watch mode during development for auto-rebuilds npm run watch

4. Run the server (example) node build/index.js

5. If integrating with Claude Desktop, prepare the configuration file as shown in the README (see installation section below) and point the client to the built server entry point.

Tips and notes:

• MCP servers communicate over stdio; debugging can be challenging. Consider using the MCP Inspector for debugging, available as a package script via npm run inspector, which provides a URL to a browser-based debugging interface.
• The README includes an example Claude Desktop config that registers the server under mcpServers. If you use Claude Desktop, place the config at the specified path for your OS.
• The server stores notes in its internal state; note values (title, content, metadata) are represented as resources with mime type text/plain. Access notes via note:// URIs.
• If you modify the server or its prompts, rebuild to reflect changes in the built output located at build/index.js.