WIP: VS Code MCP

CONTRIBUTING.md

@@ -174,15 +174,24 @@ rsvg-convert -w 128 -h 128 images/dh-logo-128.svg -o images/dh-logo-128.png
 ```
 
 ## Icon Font Generation
-The extension uses an icon font generated from SVGs in `@deephaven/icons`. Running the generator requires a local checkout of web-client-ui.
+The extension uses icon fonts generated from SVGs. There are two icon fonts:
+1. `dh-ext`: Extension-specific icons from `icons/src`
+2. `dh`: Deephaven icons from `@deephaven/icons`
 
-The generator can be run via the following script, where `<path-to-dh-icons-directory>` is the location of `packages/icons/src/icons` in `web-client-ui`.
+### Extension Icons
+To generate the `dh-ext` icon font from local SVGs in `icons/src`:
 ```sh
-npm run icon:gen -- <path-to-dh-icons-directory>
+npm run icon:gen:ext
 ```
 
-The script will automatically copy `icons/dist/dh-icons.woff2` file to the `/assets` folder of the extension, but the contents of `icons/dist/dh/dh-contributes-icons.json` has to be manually copied to the `package.json` `contributes/icons` section.
-> Note: All of the icons should be consumed via the `dh-xxx` icon ids, so no code changes should be necessary unless icons have been renamed or removed.
+### Deephaven Icons
+Generating the `dh` icon font requires a local checkout of web-client-ui. Run the following where `<path-to-dh-icons-directory>` is the location of `packages/icons/src/icons` in `web-client-ui`:
+```sh
+npm run icon:gen:dh -- <path-to-dh-icons-directory>
+```
+
+The script will automatically copy the `.woff2` files to the `/assets` folder of the extension, but the contents of `icons/dist/dh*/dh*-contributes-icons.json` files need to be manually copied to the `package.json` `contributes/icons` section.
+> Note: All of the icons should be consumed via the `dh-xxx` or `dh-ext-xxx` icon ids, so no code changes should be necessary unless icons have been renamed or removed.
 
 ## Implementation Notes
 

docs/mcp.md

@@ -0,0 +1,54 @@
+# Deephaven VS Code MCP Server (experimental)
+
+## MCP Tools
+
+The extension provides 17 MCP tools for interacting with Deephaven servers:
+
+### Server & Connection Management
+- **connectToServer** - Create a connection to a Deephaven server
+- **listConnections** - List all active Deephaven connections
+- **listServers** - List all Deephaven servers with optional filtering
+- **setEditorConnection** - Set connection for an editor by URI
+- **startPipServer** - Start a managed Deephaven pip server
+
+### Code Execution
+- **runCode** - Execute arbitrary code text in a Deephaven session
+- **runCodeFromUri** - Execute code from a workspace file URI
+
+### Table Operations
+- **getColumnStats** - Get statistical information for a table column
+- **getTableStats** - Get schema and statistics for a table
+- **queryTableData** - Query table data with filters, aggregations, and sorting
+
+### Panel & Variable Management
+- **listPanelVariables** - List panel variables for a connection
+- **openVariablePanels** - Open variable panels for a connection
+
+### Workspace & File Management
+- **addRemoteFileSources** - Add remote file source folders to the workspace
+- **openFilesInEditor** - Open files in VS Code editor
+
+### Diagnostics & Utilities
+- **checkPythonEnvironment** - Check if Python environment supports Deephaven pip server
+- **getLogs** - Get log history from debug output channel
+- **showOutputPanel** - Show Deephaven output panel in VS Code
+
+## Installation
+
+For VS Code and Windsurf, you can manually download and install the latest mcp-dev .vsix:
+
+   [vscode-deephaven-1.1.10-mcp-dev.0.vsix](https://github.com/deephaven/vscode-deephaven/raw/refs/heads/mcp/releases/vscode-deephaven-1.1.10-mcp-dev.0.vsix)
+
+### VS Code
+- Download and install the .vsix
+- Restart VS Code
+- A toast message should say that Deephaven MCP Server has started
+- No need to configure anything. Copilot should now have access to the MCP server
+
+### Windsurf
+- Download and install the .vsix
+- Restart Windsurf
+- Should see a prompt "Your Windsurf MCP config doesn't match this workspace's 'Deephaven VS Code MCP Server'. Update to port XXXXX?"
+- Say "yes" for this time or "always" for it to automatically update when you switch windows
+
+> Note Windsurf only supports a global mcp server configuration (`~/.codeium/windsurf/mcp_config.json`), but the extension assigns a unique MCP port to each workspace. This means whenever you switch workspaces, you will be prompted to sync the port again so that Cascade can talk to the correct MCP server.

icons/generate.mjs

@@ -1,8 +1,12 @@
 /**
  * This script generates an icon font + manifest from a directory of SVG files.
+ *
  * Usage:
+ *   npm run icon:gen:ext                            # Generate dh-ext icons from icons/src
+ *   npm run icon:gen:dh -- <path-to-dh-icons-dir>   # Generate dh icons from @deephaven/icons
  *
- * npm run icon:gen -- <path-to-icons-directory>
+ * If running the script directly, both prefix and path are required:
+ *   node icons/generate.mjs <prefix> <path-to-icons-directory>
  */
 
 /* eslint-disable no-console */