geekmonks-mcp-bookmarks

GeekMonks MCP シリーズのコンパニオンラボ: stdio 上で動作するローカル bookmarks MCP サーバー (TypeScript)。

• シリーズハブ: MCP Without the Hype

• チェックポイントタグ: part-3 (ツールのみ)、part-4 (ツール + リソース bookmarks://list + プロンプト summarize-bookmarks)

ホストに関する注意: ツールは Cursor で最も確実に表示されます。ホスト UI が制限されている場合でも、リソース と プロンプト は MCP Inspector で確認してください。

要件

• Node.js 20+

Related MCP server: raindrop-mcp

セットアップ

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

任意: BOOKMARKS_PATH を JSON ファイルのパスに設定します。デフォルトのストア: ./data/bookmarks.json (初回使用時に作成され、gitignore されます)。

MCP Inspector (Cursor を使わずにツールを検証)

npm run build 実行後、リポジトリのルートから:

npx @modelcontextprotocol/inspector node dist/index.js

接続して Tools を開き、list_bookmarks / add_bookmark / search_bookmarks を試してください。

タグ part-4 では、Resources (bookmarks://list) と Prompts (summarize-bookmarks) も確認してください。

Cursor (mcp.json)

プロジェクト設定の例 (絶対パスを調整してください):

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

MCP をリロードするか、新しい Agent チャットを開始してください。プロンプトが表示されたらツール呼び出しを承認してください。

ロギングルール

プロトコルのノイズを stdout に書き込まないでください。このサーバーは console.error (stderr) のみでログを出力します。

ライセンス

MIT