Code MCP

This monorepo contains the Code MCP Server and its companion VS Code extension, which together enable AI agents and assistants, like Goose or Claude, to interact with VS Code through the Model Context Protocol.

Project Structure

code-mcp/
├── server/    # MCP server implementation
└── extension/ # VS Code extension

Quick Start

1. Install the MCP Server

npx code-mcp-server install

2. Install the MCP Extension

MCP Extension

Configuration

Goose Desktop Setup

• ID: code-mcp
• Name: VS Code
• Description: Allows interaction with VS Code through the Model Context Protocol
• Command: npx code-mcp-server

Claude Desktop Setup

Add this to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "code-mcp-server": {
      "command": "npx",
      "args": ["code-mcp-server"],
      "env": {}
    }
  }
}

Available Tools

The Code MCP server provides the following tools for AI agents to interact with VS Code:

create_diff

Creates and shows a diff for modifying existing files:

• Shows changes preview before applying
• Requires user approval
• Only works with existing files

open_file

Opens files in the VS Code editor:

• Used for viewing new or modified files

open_project

Opens a project folder in VS Code:

• Sets up working directory for AI agent

check_extension_status

Checks if extension is installed and responding

get_extension_port

Gets the port number for VS Code MCP Extension

list_available_projects

Shows projects from port registry file

License

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

Copyright 2025 Block, Inc.

This product includes software developed at Block, Inc.