What is Vscode Context Mcp Extension

The vscode-context-mcp-extension is a Visual Studio Code extension designed to help developers manage project context efficiently by storing and organizing relevant files and code snippets, making it easier to switch between tasks in complex projects.

Use cases

Use cases include managing multiple files and code snippets during development, quickly switching between tasks while retaining important context, and integrating with external tools via the REST API to enhance productivity.

How to use

To use the vscode-context-mcp-extension, install it by downloading the .vsix file from the releases page, then install it in VS Code via the Extensions view. Open your project, access the Project Session Manager sidebar, and use keyboard shortcuts (Ctrl+L to add the current file, Ctrl+I to add selected code) to manage your context.

Key features

Key features include context management with the ability to add files and code snippets, terminal integration for accessing terminal content, and a Context Explorer for managing context files. Additionally, it provides a REST API for external tools to integrate with the VS Code environment.

Where to use

The vscode-context-mcp-extension is useful in software development environments, particularly for developers working on complex projects that require frequent context switching and organization of code snippets and files.

Project Session Manager

A Visual Studio Code extension that enables developers to efficiently manage project context by storing and organizing relevant files and code snippets. This extension helps maintain context when working on complex projects, making it easier to switch between tasks while preserving important references.

Features

Context Management

• Add Files to Context: Quickly add entire files to your current session with Ctrl+L (Cmd+L on macOS)
• Add Code Selections: Capture specific code snippets with Ctrl+I (Cmd+I on macOS)
• Terminal Integration: Access terminal content directly from your session
• Context Explorer: View and manage all context files in a dedicated sidebar

REST API Integration

The extension provides a REST API server running on port 4569, allowing external tools to integrate with your VS Code environment:

• Get project path information
• Access currently open files and their content
• Retrieve terminal outputs
• View project diagnostics (errors and warnings)
• Manage session context via HTTP endpoints

Installation

1. Download the .vsix file from the releases page
2. In VS Code, go to the Extensions view (Ctrl+Shift+X)
3. Click on the “…” in the top right of the Extensions view
4. Select “Install from VSIX…” and choose the downloaded file
5. Reload VS Code when prompted

Getting Started

1. Open your project in VS Code
2. Navigate to the Project Session Manager sidebar icon in the Activity Bar
3. Use keyboard shortcuts to add files or code snippets to your context:
   • Ctrl+L (Cmd+L on macOS): Add the current file to context
   • Ctrl+I (Cmd+I on macOS): Add selected code to context
4. View and manage your context files in the sidebar

REST API Reference

The extension runs a local REST API server on port 4569 with the following endpoints:

API Examples

Get Current File Information

GET http://localhost:4569/current-file

Response:

{
  "fileName": "c:\\Projects\\example\\src\\index.js",
  "languageId": "javascript",
  "lineCount": 42,
  "uri": "file:///c%3A/Projects/example/src/index.js",
  "isDirty": false,
  "isUntitled": false,
  "content": "// File content here..."
}

Get Open Editor Tabs

GET http://localhost:4569/open-tabs

Response:

{
  "openTabs": [
    {
      "fileName": "c:\\Projects\\example\\src\\index.js",
      "languageId": "javascript",
      "uri": "file:///c%3A/Projects/example/src/index.js",
      "isActive": true,
      "isDirty": false,
      "isUntitled": false
    },
    {
      "fileName": "c:\\Projects\\example\\package.json",
      "languageId": "json",
      "uri": "file:///c%3A/Projects/example/package.json",
      "isActive": false,
      "isDirty": true,
      "isUntitled": false
    }
  ]
}

Development

Prerequisites

• Node.js (v14+) and npm
• Visual Studio Code

Setup

1. Clone the repository

git clone https://github.com/vilasone455/vscode-project-context-mcp.git
cd project-session-manager

2. Install dependencies

npm install

3. Build the extension

npm run build

Development Workflow

1. Start the watch process to automatically compile changes:

npm run watch

2. Press F5 in VS Code to launch the extension in debug mode

3. Make changes to the code

4. To package the extension for distribution:

vsce package

Troubleshooting

• Port Conflicts: If you see an error about port 4569 being in use, you may have another instance of the extension running. Restart VS Code to resolve this.

License

This project is licensed under the MIT License - see the LICENSE file for details.