geekmonks-mcp-bookmarks

Companion lab for the GeekMonks MCP series: a local bookmarks MCP server over stdio (TypeScript).

• Series hub: MCP Without the Hype
• Checkpoint tags: part-3 (tools only), part-4 (tools + resource bookmarks://list + prompt summarize-bookmarks)

Host note: tools show up most reliably in Cursor. Verify resources and prompts with MCP Inspector even when the host UI is limited.

Requirements

• Node.js 20+

Setup

git clone https://github.com/SRVivek1/geekmonks-mcp-bookmarks.git
cd geekmonks-mcp-bookmarks
git checkout part-3   # or part-4
npm install
npm run build

Optional: set BOOKMARKS_PATH to a JSON file path. Default store: ./data/bookmarks.json (created on first use; gitignored).

MCP Inspector (prove tools without Cursor)

From the repo root after npm run build:

npx @modelcontextprotocol/inspector node dist/index.js

Connect, open Tools, try list_bookmarks / add_bookmark / search_bookmarks.

On tag part-4, also check Resources (bookmarks://list) and Prompts (summarize-bookmarks).

Cursor (mcp.json)

Project config example (adjust the absolute path):

{
  "mcpServers": {
    "bookmarks": {
      "type": "stdio",
      "command": "node",
      "args": ["/ABS/PATH/TO/geekmonks-mcp-bookmarks/dist/index.js"]
    }
  }
}

Reload MCP / start a new Agent chat. Approve tool calls when prompted.

Logging rule

Never write protocol noise to stdout. This server logs only with console.error (stderr).

License

MIT