notes-mcp-server (TypeScript template)

A stdio MCP server with two tools (search_notes, add_note), one resource (notes://all), and one prompt (weekly-review). Notes are stored in a JSON file.

Build & test

npm install
npm run build
npm run smoke      # automated handshake + tools/list check (prints PASS)
npm run inspect    # interactive MCP Inspector

Configuration

Env var	Default	Purpose
NOTES_FILE	~/.notes-mcp.json	Where notes are stored

Connect

Cursor (.cursor/mcp.json):

{ "mcpServers": { "notes": { "command": "node", "args": ["C:/path/to/typescript-server/build/index.js"] } } }

Claude Code:

claude mcp add notes -- node C:/path/to/typescript-server/build/index.js

For more clients, see Connect to clients.