Skip to main content
For installation instructions, see the Quickstart.

​
Prerequisites

  • VS Code installed
  • GitHub Copilot extension installed
  • GitHub Copilot subscription (Individual, Business, or Enterprise)
MCP support in GitHub Copilot requires VS Code 1.99+ and GitHub Copilot extension version 1.250+.
For more details, see the official VS Code MCP documentation.

​
Troubleshooting

  1. Open the Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows/Linux)
  2. Run MCP: Open User Configuration
  3. Add the Neptune configuration to your mcp.json file
Use MCP: Open Remote User Configuration if you want the server to run on a remote machine when connected remotely.
Add this to your mcp.json:
{
  "servers": {
    "neptune": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/shuttle-hq/neptune-cli-python.git", "neptune", "mcp"]
    }
  }
}
On Windows:
{
  "servers": {
    "neptune": {
      "command": "cmd",
      "args": ["/c", "uvx", "--from", "git+https://github.com/shuttle-hq/neptune-cli-python.git", "neptune", "mcp"]
    }
  }
}
VS Code can’t find the uv package manager.
  1. Install uv:
# macOS
brew install uv

# Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  1. Reload VS Code window (Cmd+Shift+P → “Reload Window”)
MCP support requires:
  1. VS Code version 1.99 or later
  2. GitHub Copilot extension version 1.250 or later
  3. Active GitHub Copilot subscription
Update both VS Code and the Copilot extension if MCP options aren’t available.
  1. Make sure you’ve reloaded VS Code after adding the configuration
  2. Open Copilot Chat (Cmd+Shift+I or Ctrl+Shift+I)
  3. Try asking: “What MCP tools do you have?”
  4. Check the Output panel for any error messages (View → Output → GitHub Copilot)
On Windows, wrap the command with cmd /c:
{
  "servers": {
    "neptune": {
      "command": "cmd",
      "args": ["/c", "uvx", "--from", "git+https://github.com/shuttle-hq/neptune-cli-python.git", "neptune", "mcp"]
    }
  }
}

​
Verify Installation

To verify Neptune is working:
  1. Open Copilot Chat in VS Code (Cmd+Shift+I or Ctrl+Shift+I)
  2. Ask: “What Neptune tools do you have access to?”
  3. You should see a list including login, deploy_project, etc.

​
Next Steps

Quickstart

Continue with authentication and deploy your first app