geekmonks-mcp-bookmarks
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 + recursobookmarks://list+ promptsummarize-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: bookmarks-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 buildOpcional: 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.jsConecta, 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
Available Tools
3 toolsadd_bookmarkAdd bookmarkA
Add a bookmark with a title and URL to the local JSON store.
Inputs: url (required), title (required).
list_bookmarksList bookmarksA
List all saved bookmarks from the local JSON store.
Inputs: no named parameters.
search_bookmarksSearch bookmarksA
Search bookmarks by substring match on title or URL.
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a distinct purpose: listing, adding, and searching bookmarks. There is no overlap or ambiguity between them.
All tool names follow a consistent verb_noun pattern: list_bookmarks, add_bookmark, search_bookmarks. The pattern is clear and predictable.
With only 3 tools, the server is minimal but covers the basic operations for a bookmark store. It feels slightly thin but is reasonable for a simple local JSON store.
The server provides list, add, and search, but lacks update and delete operations, which are common for bookmark management. This is a notable gap but agents can work around it by not needing those operations.
Maintenance
Related MCP Connectors
Personal knowledge MCP: capture bookmarks, notes & todos by chat; archive pages; search memory.
Search, label, and manage your X (Twitter) bookmarks from any MCP client via Tweetsmash
Official Bookmax MCP server: search and save bookmarks, read notes and docs from AI assistants.
Search and chat with your X bookmarks, with citations back to the original posts.
Related MCP Servers
- AlicenseAqualityFmaintenanceA bookmark management MCP server that enables saving, searching, and managing bookmarks with tags and read/unread status, providing tools, resources, and prompts for integration.4MIT
- FlicenseAqualityCmaintenanceEnables AI assistants to search, browse, add, and delete Chrome and Edge bookmarks through the MCP protocol, using a local FastMCP server that directly reads and modifies browser bookmark files.5-
- AlicenseNot gradedqualityDmaintenanceProvides authenticated bookmark management tools via MCP, including adding, deleting, listing, and searching bookmarks.2,274 npmMIT
- AlicenseAqualityBmaintenanceEnables reading and writing Chrome bookmarks (folders, URLs, search, move, remove) through MCP clients like Claude Code, using a companion Chrome extension for secure local communication.1118 npm1MIT