geekmonks-mcp-bookmarks

Laboratorio complementario para la serie GeekMonks MCP: un servidor MCP local de bookmarks sobre stdio (TypeScript).

• Centro de la serie: MCP Without the Hype

• Etiquetas de checkpoint: part-3 (solo herramientas), part-4 (herramientas + recurso bookmarks://list + prompt summarize-bookmarks)

Nota sobre el host: las herramientas aparecen de forma más fiable en Cursor. Verifica los recursos y prompts con MCP Inspector incluso cuando la interfaz del host sea limitada.

Requisitos

• Node.js 20+

Related MCP server: raindrop-mcp

Configuración

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

Opcional: establece BOOKMARKS_PATH a una ruta de archivo JSON. Almacén predeterminado: ./data/bookmarks.json (se crea en el primer uso; ignorado por git).

MCP Inspector (probar herramientas sin Cursor)

Desde la raíz del repositorio después de npm run build:

npx @modelcontextprotocol/inspector node dist/index.js

Conecta, abre Tools, prueba list_bookmarks / add_bookmark / search_bookmarks.

En la etiqueta part-4, comprueba también Resources (bookmarks://list) y Prompts (summarize-bookmarks).

Cursor (mcp.json)

Ejemplo de configuración del proyecto (ajusta la ruta absoluta):

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

Recarga MCP / inicia una nueva conversación de Agent. Aprueba las llamadas a herramientas cuando se te solicite.

Regla de registro

Nunca escribas ruido de protocolo en stdout. Este servidor solo registra con console.error (stderr).

Licencia

MIT