{"_id":"@adocc/bookmarks-mcp","_rev":"3-c36650138f59b75dd9012301647e501e","name":"@adocc/bookmarks-mcp","dist-tags":{"latest":"2.0.1"},"versions":{"2.0.0":{"name":"@adocc/bookmarks-mcp","version":"2.0.0","keywords":["mcp","model-context-protocol","bookmarks","adocc","claude","ai"],"author":{"name":"ADOCC","email":"hello@adocc.io"},"license":"MIT","_id":"@adocc/bookmarks-mcp@2.0.0","maintainers":[{"name":"fabricadtiempo","email":"contacto@lafabricadeltiempo.es"}],"homepage":"https://github.com/adocc-io/adocc-ext/tree/main/packages/bookmarks-mcp#readme","bugs":{"url":"https://github.com/adocc-io/adocc-ext/issues"},"bin":{"bookmarks-mcp":"dist/index.js"},"dist":{"shasum":"34969fcf38f49ea69e37df5aa166d16e2e4aed27","tarball":"https://registry.npmjs.org/@adocc/bookmarks-mcp/-/bookmarks-mcp-2.0.0.tgz","fileCount":10,"integrity":"sha512-MUMJMZoZ9UKiF52JJI2tOqUWWhnyo+5i0Qpgu40Yt8mPY7/5ux0lg8vBDtq9l3G4UEke5D/7BbkMcLr7mFbqng==","signatures":[{"sig":"MEQCIDcn+KALuEWRJmnEhF2eiieQe+I6s+ykEfptfK1hnCQeAiB9PhJebA/YgMDE+8VdfcRTMZN/00JPw0r88kF/Sini7g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":51490},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"gitHead":"08c25e190adaa59781f97b3f2dcb702808f95b59","scripts":{"dev":"tsc --watch","test":"vitest run --config vitest.config.ts","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"fabricadtiempo","email":"contacto@lafabricadeltiempo.es"},"repository":{"url":"git+https://github.com/adocc-io/adocc-ext.git","type":"git","directory":"packages/bookmarks-mcp"},"_npmVersion":"11.6.2","description":"MCP server for managing bookmarks from ADOCC extension","directories":{},"_nodeVersion":"24.13.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.10.0"},"_npmOperationalInternal":{"tmp":"tmp/bookmarks-mcp_2.0.0_1770057526807_0.026417689014123225","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."},"2.0.1":{"name":"@adocc/bookmarks-mcp","version":"2.0.1","keywords":["mcp","model-context-protocol","bookmarks","adocc","claude","ai"],"author":{"name":"ADOCC","email":"hello@adocc.io"},"license":"MIT","_id":"@adocc/bookmarks-mcp@2.0.1","maintainers":[{"name":"fabricadtiempo","email":"contacto@lafabricadeltiempo.es"}],"homepage":"https://github.com/adocc-io/adocc-ext/tree/main/packages/bookmarks-mcp#readme","bugs":{"url":"https://github.com/adocc-io/adocc-ext/issues"},"bin":{"bookmarks-mcp":"dist/index.js"},"dist":{"shasum":"6e05c9684c13fc065a2581aed3f4ece1dc82e78a","tarball":"https://registry.npmjs.org/@adocc/bookmarks-mcp/-/bookmarks-mcp-2.0.1.tgz","fileCount":6,"integrity":"sha512-KZjVdPYF3ArnV7ym7PJ0e2rx3jH/7sowgyu1JK0JQYFi9Uc4T+VIgK6hhjFXRjuNMjNnhjWaJN8Se++mT6LM4g==","signatures":[{"sig":"MEQCIFpyUq5zLhUm9vinWQMmtr8nAgG/i9lSydUGwkX02pKkAiAvUyfFX1lASoHWkd7WGfO3Ibyav0QyF/+XTRnUPlGVFw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37586},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"gitHead":"08c25e190adaa59781f97b3f2dcb702808f95b59","scripts":{"dev":"tsc --watch","test":"vitest run --config vitest.config.ts","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"fabricadtiempo","email":"contacto@lafabricadeltiempo.es"},"repository":{"url":"git+https://github.com/adocc-io/adocc-ext.git","type":"git","directory":"packages/bookmarks-mcp"},"_npmVersion":"11.6.2","description":"MCP server for managing bookmarks from ADOCC extension","directories":{},"_nodeVersion":"24.13.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.10.0"},"_npmOperationalInternal":{"tmp":"tmp/bookmarks-mcp_2.0.1_1770057596368_0.5800211731518143","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."}},"time":{"created":"2026-02-02T18:38:46.712Z","modified":"2026-03-05T09:27:57.420Z","2.0.0":"2026-02-02T18:38:46.955Z","2.0.1":"2026-02-02T18:39:56.511Z"},"bugs":{"url":"https://github.com/adocc-io/adocc-ext/issues"},"author":{"name":"ADOCC","email":"hello@adocc.io"},"license":"MIT","homepage":"https://github.com/adocc-io/adocc-ext/tree/main/packages/bookmarks-mcp#readme","keywords":["mcp","model-context-protocol","bookmarks","adocc","claude","ai"],"repository":{"url":"git+https://github.com/adocc-io/adocc-ext.git","type":"git","directory":"packages/bookmarks-mcp"},"description":"MCP server for managing bookmarks from ADOCC extension","maintainers":[{"name":"fabricadtiempo","email":"contacto@lafabricadeltiempo.es"}],"readme":"# @adocc/bookmarks-mcp\n\nMCP (Model Context Protocol) server para gestionar los marcadores de ADOCC desde agentes de IA como Claude.\n\nEl sistema ADOCC organiza las herramientas en 4 dimensiones:\n- **Acción**: Herramientas para ejecutar tareas (Asana, Trello, Jira...)\n- **Documentación**: Herramientas para documentar (Notion, Google Docs, Confluence...)\n- **Comunicación**: Herramientas para comunicar (Slack, Teams, Email...)\n- **Conocimiento**: Herramientas para gestionar conocimiento (wikis, bases de conocimiento...)\n\n## Instalación\n\n```bash\nnpm install -g @adocc/bookmarks-mcp\n```\n\nO usar directamente con npx:\n\n```bash\nnpx @adocc/bookmarks-mcp\n```\n\n## Configuración con Claude Desktop\n\nAñade a tu configuración de Claude Desktop (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"adocc-bookmarks\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@adocc/bookmarks-mcp\"]\n    }\n  }\n}\n```\n\n## Autenticación\n\nAntes de usar el MCP, necesitas configurar el token de autenticación. Puedes obtenerlo desde la extensión o la app web de ADOCC.\n\n```\nUsa la herramienta 'configure' con tu token\n```\n\nEl token se guarda en `~/.bookmarks-adocc/config.json`.\n\n## Herramientas disponibles\n\n### configure\nConfigura el token de autenticación y la URL del servidor.\n\n**Parámetros:**\n- `token` (string, requerido): Token de autenticación\n- `serverUrl` (string, opcional): URL del servidor (default: https://bookmarks.adocc.es)\n\n### search_bookmarks\nBusca en los marcadores de la organización.\n\n**Parámetros:**\n- `query` (string, requerido): Texto a buscar\n\n**Ejemplo:**\n```\nBusca \"documentación\" en mis marcadores\n```\n\n### get_tools_for_dimension\nObtiene las herramientas disponibles para una dimensión ADOCC.\n\n**Parámetros:**\n- `dimension` (string, requerido): accion | documentacion | comunicacion | conocimiento\n\n**Ejemplo:**\n```\n¿Qué herramientas tengo para documentación?\n```\n\n### get_tool_for_task\nSugiere la herramienta más adecuada para una tarea específica.\n\n**Parámetros:**\n- `task` (string, requerido): Descripción de la tarea\n\n**Ejemplo:**\n```\n¿Qué herramienta debo usar para documentar una reunión?\n```\n\n### get_tool_by_capability\nEncuentra herramientas que tienen una capacidad específica.\n\n**Parámetros:**\n- `capability` (string, requerido): Capacidad buscada (crear, buscar, editar, compartir...)\n\n**Ejemplo:**\n```\n¿Qué herramientas me permiten crear documentos?\n```\n\n### get_bookmarks_by_tag\nFiltra marcadores por tag.\n\n**Parámetros:**\n- `tag` (string, requerido): Tag por el que filtrar\n\n### list_all_bookmarks\nLista todos los marcadores agrupados.\n\n### list_dimensions\nLista las dimensiones ADOCC y su descripción.\n\n## Ejemplo de uso con un agente\n\n```\nUsuario: Necesito documentar la reunión de hoy y avisar al equipo\n\nAgente:\n1. Consultando herramientas de documentación...\n   → Notion (dimensión: documentación, capacidades: crear, editar, compartir)\n\n2. Consultando herramientas de comunicación...\n   → Slack #general (dimensión: comunicación, capacidades: mensaje, notificar)\n\nRecomendación:\n- Documenta en Notion: https://notion.so/workspace\n- Avisa en Slack: https://slack.com/app\n```\n\n## Algoritmo de scoring de `get_tool_for_task`\n\nCuando se invoca `get_tool_for_task`, el servidor evalua cada marcador contra la tarea descrita y asigna una puntuacion basada en multiples senales.\n\n### Paso 1: Inferencia de dimension\n\nSe analiza la descripcion de la tarea para inferir la dimension ADOCC mas probable:\n\n| Dimension | Keywords |\n|---|---|\n| `documentacion` | documentar, documento, escribir, redactar, nota, acta, informe, wiki, manual |\n| `comunicacion` | comunicar, mensaje, email, correo, avisar, notificar, chat, llamar, reunion |\n| `accion` | tarea, hacer, ejecutar, crear tarea, asignar, proyecto, sprint, ticket |\n| `conocimiento` | aprender, buscar informacion, investigar, formacion, curso, tutorial, guia |\n\n### Paso 2: Scoring por marcador\n\nCada marcador recibe puntos segun estas senales:\n\n| Senal | Puntos | Condicion |\n|---|---|---|\n| Dimension match | +3 | La dimension del marcador coincide con la dimension inferida de la tarea |\n| Tag - coincidencia completa | +3 | El texto completo del tag aparece en la descripcion de la tarea |\n| Tag - coincidencia parcial | +1 | Solapamiento parcial de palabras entre el tag y la tarea |\n| Capability match | +2 | Cada capacidad del marcador (crear, buscar, editar...) que aparece en la tarea |\n| Nombre - coincidencia completa | +3 | El nombre completo del marcador aparece en la tarea |\n| Nombre - solapamiento de palabra | +1 | Alguna palabra del nombre del marcador aparece en las palabras de la tarea |\n| Descripcion - palabra | +1 | Por cada palabra de la tarea (>2 chars) que aparece en la descripcion del marcador |\n\n### Paso 3: Resultado\n\nSe ordena por puntuacion descendente y se devuelve el marcador con mayor score junto con los detalles de la puntuacion. Si hay alternativas cercanas, se incluyen.\n\n## Variables de entorno\n\nEl servidor MCP acepta las siguientes variables de entorno, que tienen prioridad sobre el fichero de configuracion (`~/.bookmarks-adocc/config.json`):\n\n| Variable | Descripcion | Requerida | Default |\n|---|---|---|---|\n| `ADOCC_BOOKMARKS_TOKEN` | Token de autenticacion (Bearer token obtenido de la extension o app web) | No | Valor del fichero config |\n| `ADOCC_BOOKMARKS_URL` | URL del servidor de bookmarks | No | `https://bookmarks.adocc.es` |\n\n**Prioridad de configuracion** (de mayor a menor):\n1. Variables de entorno (`ADOCC_BOOKMARKS_TOKEN`, `ADOCC_BOOKMARKS_URL`)\n2. Fichero de configuracion (`~/.bookmarks-adocc/config.json`)\n3. Valores por defecto\n\n**Ejemplo con variables de entorno:**\n\n```bash\nADOCC_BOOKMARKS_TOKEN=tu-token-aqui npx @adocc/bookmarks-mcp\n```\n\n**Ejemplo en configuracion de Claude Desktop:**\n\n```json\n{\n  \"mcpServers\": {\n    \"adocc-bookmarks\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@adocc/bookmarks-mcp\"],\n      \"env\": {\n        \"ADOCC_BOOKMARKS_TOKEN\": \"tu-token-aqui\"\n      }\n    }\n  }\n}\n```\n\n## Desarrollo\n\n```bash\n# Instalar dependencias\nnpm install\n\n# Build\nnpm run build\n\n# Ejecutar en modo desarrollo\nnpm run dev\n```\n\n## Licencia\n\nMIT - La Fábrica del Tiempo\n","readmeFilename":"README.md"}