NCP Setup for VS Code

🚀 Quick Setup

Step 1: Install NCP

npm install -g @portel/ncp

Step 2: Configure MCP Server

Create .vscode/mcp.json in your workspace root:

{
  "servers": {
    "ncp": {
      "type": "stdio",
      "command": "ncp"
    }
  }
}

Step 3: Reload VS Code

Open Command Palette (Cmd/Ctrl + Shift + P) → Developer: Reload Window

---

📖 Official Documentation

For complete VS Code MCP setup, troubleshooting, and requirements:

📚 Official VS Code MCP Guide

📚 GitHub Copilot MCP Documentation

Requirements:

• VS Code 1.99 or later
• GitHub Copilot subscription
• MCP and Agent Mode enabled in settings

---

⚙️ NCP-Specific Configuration

Using Profiles

Separate work and personal MCPs:

{
  "servers": {
    "ncp-work": {
      "type": "stdio",
      "command": "ncp",
      "env": {
        "NCP_PROFILE": "work"
      }
    },
    "ncp-personal": {
      "type": "stdio",
      "command": "ncp",
      "env": {
        "NCP_PROFILE": "personal"
      }
    }
  }
}

Debug Logs

Enable logging to ~/.ncp/logs/:

{
  "servers": {
    "ncp": {
      "type": "stdio",
      "command": "ncp",
      "env": {
        "NCP_DEBUG": "true"
      }
    }
  }
}

Custom Working Directory

{
  "servers": {
    "ncp": {
      "type": "stdio",
      "command": "ncp",
      "env": {
        "NCP_WORKING_DIR": "${workspaceFolder}"
      }
    }
  }
}

---

💡 What NCP Provides

• ncp_find - Semantic search across all your MCPs
• ncp_run - Execute any tool with proper parameter handling

Result: 90%+ token savings, longer conversations, just-in-time tool loading.

---

Need help? Troubleshooting Guide | Open an issue