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

​
Prerequisites

​
Configuration

MCP servers are configured in the cline_mcp_settings.json file. Access it via the MCP Servers icon in the Cline panel → Configure tab → Configure MCP Servers.
For more details, see the official Cline MCP documentation.

​
Troubleshooting

  1. Click the MCP Servers icon in the top navigation bar of the Cline panel
  2. Select the Configure tab
  3. Click Configure MCP Servers to open cline_mcp_settings.json
  4. Add the Neptune configuration
Make sure your cline_mcp_settings.json has the correct structure:
{
  "mcpServers": {
    "neptune": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/shuttle-hq/neptune-cli-python.git", "neptune", "mcp"]
    }
  }
}
Note: The config uses mcpServers (same format as Claude Desktop).
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”)
On Windows, you must wrap the command with cmd /c:
{
  "mcpServers": {
    "neptune": {
      "command": "cmd",
      "args": ["/c", "uvx", "--from", "git+https://github.com/shuttle-hq/neptune-cli-python.git", "neptune", "mcp"]
    }
  }
}
  1. Make sure Cline extension is installed and enabled
  2. Reload VS Code window after adding configuration
  3. Try asking Cline: “What MCP tools do you have?”
Make sure you’re using a Cline version that supports MCP. Update the extension:
  1. Go to Extensions (Cmd+Shift+X)
  2. Find Cline
  3. Click “Update” if available

​
Verify Installation

To verify Neptune is working:
  1. Open Cline in VS Code
  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