geekmonks-mcp-bookmarks

Das Begleitprojekt zur GeekMonks-MCP-Serie: ein lokaler bookmarks-MCP-Server über stdio (TypeScript).

• Serien-Hub: MCP Without the Hype

• Checkpoint-Tags: part-3 (nur Tools), part-4 (Tools + Ressource bookmarks://list + Prompt summarize-bookmarks)

Hinweis zum Host: Tools werden in Cursor am zuverlässigsten angezeigt. Prüfen Sie Ressourcen und Prompts mit dem MCP Inspector, auch wenn die Host-Oberfläche eingeschränkt ist.

Voraussetzungen

• Node.js 20+

Related MCP server: raindrop-mcp

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: Setzen Sie BOOKMARKS_PATH auf den Pfad einer JSON-Datei. Standardspeicherort: ./data/bookmarks.json (wird bei erster Verwendung erstellt; per .gitignore ignoriert).

MCP Inspector (Tools ohne Cursor prüfen)

Vom Repository-Root aus nach npm run build:

npx @modelcontextprotocol/inspector node dist/index.js

Verbinden Sie sich, öffnen Sie Tools und testen Sie list_bookmarks / add_bookmark / search_bookmarks.

Beim Tag part-4 zusätzlich Ressourcen (bookmarks://list) und Prompts (summarize-bookmarks) prüfen.

Cursor (mcp.json)

Beispiel für die Projektkonfiguration (absoluten Pfad anpassen):

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

MCP neu laden und einen neuen Agent-Chat starten. Bestätigen Sie Tool-Aufrufe, wenn Sie dazu aufgefordert werden.

Protokollierungsregel

Schreiben Sie niemals Protokollrauschen auf stdout. Dieser Server protokolliert ausschließlich mit console.error (stderr).

Lizenz

MIT