geekmonks-mcp-bookmarks

Сопутствующая лаборатория для серии GeekMonks MCP: локальный MCP-сервер bookmarks через stdio (TypeScript).

• Серия: MCP Without the Hype

• Теги контрольных точек: part-3 (только инструменты), part-4 (инструменты + ресурс bookmarks://list + промпт summarize-bookmarks)

Примечание для хоста: инструменты наиболее стабильно отображаются в Cursor. Проверяйте ресурсы и промпты через 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