bookmark-manager

The Bookmark Manager MCP server provides a persistent bookmark storage system that integrates with MCP-compatible clients like Claude and Claude Code, as well as other MCP-enabled tooling. It exposes a resource set for managing bookmarks (including categories) and stores data locally in the container at /app/.data, which is mounted to your host at ~/.data. You can interact with the server through standard MCP clients to add, list, and search bookmarks, leveraging the built-in category support and per-category discovery via resources like bookmarks://all, bookmarks://general, or bookmarks://{category}. The server is implemented in TypeScript with type-safe validation and offers a container image for easy deployment.

Prerequisites:\n- Docker or Podman installed on your host.\n- Access to pull the bookmark-manager-mcp container image.\n\nInstall steps:\n1) Ensure prerequisites are met (Docker/Podman installed).\n2) Pull the latest image (example with Docker):\n\nbash\ndocker pull mindriftfall2infinitepiio/bookmark-manager-mcp:latest\n\n3) Create a local data directory to persist bookmarks (optional if using container volume mapping):\n\nbash\nmkdir -p ~/.data\n\n4) Run the MCP server using Docker: (from the project Readme example)\n\nbash\ndocker run --rm --interactive --volume ~/.data:/app/.data mindriftfall2infinitepiio/bookmark-manager-mcp:latest\n\n5) Verify the server starts and is reachable via MCP clients (Claude Code or Claude Code Integration). For Podman, substitute docker with podman in the same commands.\n6) (Optional) If you need to tailor with a different data path inside the container, adjust the volume mapping accordingly, but keep /app/.data as the container path for persistence.\n

Notes and tips:\n- Data storage path inside the container is /app/.data, mapped to ~/.data on the host for persistence. Ensure the host path has proper permissions.\n- The container image is based on node:22-alpine and uses a Node/TypeScript stack with the @modelcontextprotocol/sdk. If you need to customize behavior, you can adjust mounting or environment variables as supported by the container image (check image docs).\n- When integrating with Claude or Claude Code, you can use the provided commands to add the bookmark-manager server as a CLAUDE MCP source, typically by running docker or podman commands shown in the README.\n- The MCP resources exposed include bookmarks://all, bookmarks://mcp, bookmarks://general, and bookmarks://{category} for easy filtering and discovery.\n- If you’re running in a container orchestrator or on a host with strict UID/GID policies, ensure ~/.data is writable and accessible by the container.\n- For backup or migration, the JSON data format stored in bookmarks.json is human-readable and simple to back up.