MCP Bookmarks Server

Provides MCP-driven bookmark management for codebases, enabling AI-assisted annotations, navigation, and organization.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "linonon-mcpbookmarks": {
      "command": "node",
      "args": [
        "/Users/YOUR_USERNAME/.vscode/mcp-bookmarks-launcher.js"
      ]
    }
  }
}

You can annotate and explain your codebase with MCP Bookmarks, a VSCode extension that lets AI assistants create, organize, and navigate hierarchical bookmarks tied to your code. It helps you reveal architecture, data flows, and important components while keeping everything lightweight and shareable in your workspace.

How to use

Use MCP Bookmarks to let your AI helper annotate your codebase, or manage bookmarks yourself for quick navigation. Create groups to organize related bookmarks, add individual bookmarks at precise locations, and link to code paths with clickable references. Navigate between bookmarks with keyboard shortcuts, view the hierarchical structure in the interactive sidebar, and export your bookmarks as Markdown for sharing.

How to install

Prerequisites you need before starting: Node.js and npm installed on your system, and VSCode with project access to your workspace.

Step 1. Install the extension from a VSIX file or by building from source.

Step 2. If installing from VSIX, download the latest .vsix and install via Extensions: Install from VSIX… in VSCode.

Step 3. If installing from source, install dependencies and build, then package the extension. Follow the build steps below.

Configuration and setup

Configure MCP integration so your AI tool can interact with bookmarks. You can use multiple MCP pathways (Claude Code, Gemini, Codex, or the VSCode MCP client). The setup creates a launcher that runs your local MCP server launcher script.

The launcher script path shown in examples is typically located at ~/.vscode/mcp-bookmarks-launcher.js. You will wire this launcher into your chosen MCP client configuration.

Data storage and exports

Bookmarks are stored in .vscode/mcp-bookmarks.json within your workspace. You can commit this file to version control to share bookmarks with your team. You can also export bookmarks to Markdown for easy sharing.

Troubleshooting and notes

If you encounter issues starting the local MCP launcher, verify that the path to the launcher script exists and that Node.js is accessible in your environment. Check that your workspace contains the expected .vscode/mcp-bookmarks.json file after initial creation.

Available tools

create_group

Create a new bookmark group to organize bookmarks by topic, feature, or analysis session.

add_bookmark

Add a new bookmark to a specified group, linking to a code location with optional metadata.

batch_add_bookmarks

Add multiple bookmarks at once, enabling bulk organization and import.

list_groups

List all bookmark groups with their details.

list_bookmarks

List bookmarks with optional filters for group, category, or keywords.

get_group

Retrieve a group and all its bookmarks.

get_bookmark

Retrieve details for a single bookmark.

update_group

Update a group's title or description.

update_bookmark

Update properties of a bookmark, such as location, notes, or category.

remove_group

Delete a group and all its bookmarks.

remove_bookmark

Delete a single bookmark.

clear_all_bookmarks

Remove all bookmarks after a confirmation step.