linkvault

LinkVault MCP Server adds bookmark management capabilities to Amazon Q CLI by exposing a natural language interface for saving, organizing, and searching your Chrome bookmarks. It integrates with Amazon Q CLI to fetch page content, extract metadata, and store AI-generated tags and categories for bookmarks, including content analysis of pages to aid in categorization. You can also query and list bookmarks, including those sourced from Chrome profiles, and manage them via conversational commands in your terminal. The MCP server provides functions such as get_url_data for analyzing pages, store_url to persist bookmarks with metadata, and search_bookmarks/listing capabilities to navigate your collection. Using these tools, you can save articles, search by topic, and organize bookmarks into categories with AI-assisted tagging and descriptions.

Prerequisites:

• Python 3.10+ installed on your system
• Git (optional, for cloning the repository)
• Access to a shell/terminal with permissions to install Python packages

Installation steps:

1. Install Python dependencies

   • Run: pip install -r requirements.txt

2. Ensure scripts are executable (from the repository root)

   • Run: chmod +x main.py src/url_manager.py src/server.py

3. Set up MCP in Amazon Q CLI (see next section for details)

   • This will configure the MCP server so that the Amazon Q CLI can communicate with LinkVault

4. Start the MCP server (example using uv with the provided configuration)

   • Ensure you have the correct path to your LinkVault MCP server installation
   • Command (as configured in mcp.json): uv --directory /path/to/linkvault-mcp-server run src/server.py

5. Verify server is running by issuing a test command through Amazon Q CLI to ensure connectivity

Prerequisites summary:

• Python 3.10+
• Network access to install dependencies
• Proper file permissions for the server scripts
• Amazon Q CLI configured with the LinkVault MCP entry (see documentation below)

Tips and common issues:

• Ensure the path in your MCP configuration points to the actual LinkVault installation directory and that src/server.py is accessible.
• If you modify dependencies, re-run pip install -r requirements.txt to update packages.
• When using Chrome bookmark extraction, ensure the application has permission to read Chrome profile directories if you enable cross-profile access.
• If you encounter environment variable issues, explicitly define necessary vars in the mcp_config under the env object (e.g., PATH adjustments or API keys if needed).
• Restart the Amazon Q CLI after editing the MCP config to pick up changes.
• For content extraction, verify network access and that any required web-scraping libraries in requirements.txt are installed correctly.