vscode-mcp-server

chaworld/vscode-mcp-server

3.2

If you are the rightful owner of vscode-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The VS Code MCP Server is a portable Model Context Protocol server that allows AI assistants to interact with VS Code, supporting file management, extension control, and workspace automation.

Tools
6
Resources
0
Prompts
0

VS Code MCP Server

GitHub Python MCP

一個可攜式的 Model Context Protocol (MCP) 伺服器,讓 AI 助手能夠操作 VS Code - 支援檔案管理、擴充套件控制和工作區自動化。

English | 繁體中文

繁體中文

🌟 特色

  • 檔案操作: 讀取、寫入、建立、刪除檔案和目錄
  • 擴充套件管理: 安裝、列出、啟用/停用 VS Code 擴充套件
  • 可攜式設計: 使用 uvx/pipx 全域執行,無需絕對路徑
  • 多客戶端支援:
    • ✅ GitHub Copilot CLI
    • ✅ Claude Desktop
    • ✅ Google Gemini CLI
    • ✅ 任何支援 MCP 的客戶端

📦 安裝

方法 1: 使用 uvx (推薦)
# 從專案目錄
git clone https://github.com/chaworld/vscode-mcp-server.git
cd vscode-mcp-server
uvx --from . vscode-mcp-server
方法 2: 全域安裝
# 使用 uv
git clone https://github.com/chaworld/vscode-mcp-server.git
cd vscode-mcp-server
uv tool install --editable .

# 或使用 pipx
pipx install --editable .

# 之後可直接執行
vscode-mcp-server
方法 3: 開發模式
git clone https://github.com/chaworld/vscode-mcp-server.git
cd vscode-mcp-server
uv pip install -e .
python -m vscode_mcp_server

🔧 客戶端配置

GitHub Copilot CLI
{
  "mcpServers": {
    "vscode_local": {
      "command": "uvx",
      "args": ["--from", "/path/to/vscode-mcp-server", "vscode-mcp-server"]
    }
  }
}
Claude Desktop

檔案位置: %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "vscode_local": {
      "command": "uvx",
      "args": ["--from", "/path/to/vscode-mcp-server", "vscode-mcp-server"]
    }
  }
}
Google Gemini CLI
{
  "name": "vscode-mcp",
  "version": "0.1.0",
  "mcpServers": {
    "vscode_local": {
      "command": "uvx",
      "args": ["--from", "/path/to/vscode-mcp-server", "vscode-mcp-server"]
    }
  }
}

🛠️ 可用工具

  1. read_file - 讀取檔案內容
  2. write_file - 寫入檔案內容
  3. create_directory - 建立目錄
  4. list_directory - 列出目錄內容
  5. install_extension - 安裝 VS Code 擴充套件
  6. list_extensions - 列出已安裝的擴充套件

📖 文件

  • - 詳細的可攜式安裝說明
  • - 5 種全域安裝方法比較
  • - Claude Desktop 完整設定
  • - GitHub Copilot CLI 設定
  • - 專案結構文件

🧪 測試

# 安裝開發依賴
uv pip install -e .

# 執行測試
pytest

# 執行測試並顯示詳細輸出
pytest -v

🤝 貢獻

歡迎提交 Issues 和 Pull Requests!

📄 授權

MIT License

English

🌟 Features

  • File Operations: Read, write, create, delete files and directories
  • Extension Management: Install, list, enable/disable VS Code extensions
  • Portable Design: Run globally with uvx/pipx, no absolute paths needed
  • Multi-Client Support:
    • ✅ GitHub Copilot CLI
    • ✅ Claude Desktop
    • ✅ Google Gemini CLI
    • ✅ Any MCP-compatible client

📦 Installation

Method 1: Using uvx (Recommended)
# From project directory
git clone https://github.com/chaworld/vscode-mcp-server.git
cd vscode-mcp-server
uvx --from . vscode-mcp-server
Method 2: Global Installation
# Using uv
git clone https://github.com/chaworld/vscode-mcp-server.git
cd vscode-mcp-server
uv tool install --editable .

# Or using pipx
pipx install --editable .

# Then run directly
vscode-mcp-server
Method 3: Development Mode
git clone https://github.com/chaworld/vscode-mcp-server.git
cd vscode-mcp-server
uv pip install -e .
python -m vscode_mcp_server

🔧 Client Configuration

GitHub Copilot CLI
{
  "mcpServers": {
    "vscode_local": {
      "command": "uvx",
      "args": ["--from", "/path/to/vscode-mcp-server", "vscode-mcp-server"]
    }
  }
}
Claude Desktop

File location: %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "vscode_local": {
      "command": "uvx",
      "args": ["--from", "/path/to/vscode-mcp-server", "vscode-mcp-server"]
    }
  }
}
Google Gemini CLI
{
  "name": "vscode-mcp",
  "version": "0.1.0",
  "mcpServers": {
    "vscode_local": {
      "command": "uvx",
      "args": ["--from", "/path/to/vscode-mcp-server", "vscode-mcp-server"]
    }
  }
}

🛠️ Available Tools

  1. read_file - Read file contents
  2. write_file - Write file contents
  3. create_directory - Create directories
  4. list_directory - List directory contents
  5. install_extension - Install VS Code extensions
  6. list_extensions - List installed extensions

📖 Documentation

  • - Detailed portable installation guide
  • - Comparison of 5 global installation methods
  • - Complete Claude Desktop configuration
  • - GitHub Copilot CLI configuration
  • - Project structure documentation

🧪 Testing

# Install dev dependencies
uv pip install -e .

# Run tests
pytest

# Run tests with verbose output
pytest -v

🤝 Contributing

Issues and Pull Requests are welcome!

📄 License

MIT License

🔗 Links