A Model Context Protocol (MCP) server that provides VSCode context and filesystem operations for AI assistants.

VSCode Context MCP creates a bridge between AI assistants and your VSCode environment. It enables AI models to:

1. Access the current VSCode context (active files, tabs, terminal output)
2. Perform filesystem operations with controls
3. Execute shell commands in a controlled environment

This allows AI assistants to provide more relevant and context-aware help for software development tasks.

• Get current project path
• Retrieve active file contents and metadata
• List open editor tabs
• Access diagnostic problems (warnings/errors)
• Retrieve terminal output
• Access files attached to the workspace

• Read/write files
• Edit files with line-based changes
• Create directories
• List directory contents
• Generate directory trees
• Search for files
• Get file metadata
• Move/rename files

• Run shell commands with output capture
• Controlled execution environment

Be careful what you ask this server to run! In the Claude Desktop app, use Approve Once (not Allow for This Chat) so you can review each command, and use Deny if you don't trust the command. Permissions are dictated by the user running the server.

This tool does not yet implement comprehensive security measures, so treat it with caution.

This MCP server is designed to work with Model Context Protocol-compatible AI assistants. It enhances their ability to:

• Understand your code context
• Make informed suggestions
• Provide relevant examples
• Help debug issues
• Perform file operations on your behalf

Note: Before installation, it's recommended to uninstall similar MCP servers such as filesystem MCP to avoid conflicts.

• Download the VSIX package from here
• Open VSCode
• Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS) to open the command palette
• Type "Extensions: Install from VSIX..." and select it
• Navigate to the downloaded VSIX file and select it
• Restart VSCode after installation

For more information, visit the VSCode extension repository

First, clone or download this repository. Then, install the dependencies and build the project:

cd path/to/vscode-context-mcp
npm install
npm run build

Once built, update your Claude Desktop configuration to use the MCP server:

{
  "mcpServers": {
    "vscode-context-mpc": {
      "command": "node",
      "args": [
        "C:\\path\\to\\vscode-context-mcp\\dist\\index.js"
      ]
    }
  }
}

Note: Make sure the file path in the args array matches your actual project location.

To verify that everything is working correctly, try using this prompt in Claude:

Please check my current VSCode project and tell me what files I have open.

You can add files to your Claude context in a few ways:

• Press Ctrl+L (Windows/Linux) or Cmd+L (macOS) to add the current file
• Press Ctrl+I or Cmd+I to add only the selected text
• Open the command palette (Ctrl+Shift+P or Cmd+Shift+P) and search for:
  • "Add File to Context"
  • "Add Selection to Context"

1. Make support for multiple VSCode projects
2. Accept/Revert functionality when writing or editing files
3. Redesign UI

Contributions are welcome! Please feel free to submit a Pull Request.

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