Designed for SAP ADT and other virtual filesystems, providing access to workspace files through VS Code's FileSystemProvider with tools for listing directories, reading and editing live documents, saving, searching, and fetching diagnostics.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Workspace MCP List the workspace roots and show me the active editor's content."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Connect MCP clients such as Codex and Claude Code to the workspace open in VS Code, including virtual filesystems such as SAP ADT. Read live editor content, inspect symbols and diagnostics, and apply edits without saving automatically.
Unlike a local filesystem server, this extension uses VS Code's workspace APIs and preserves full URIs. Unsaved editor changes are included in reads.
MIT licensed. No telemetry or shell tools. Initial preview: compatibility with a real SAP backend still requires acceptance testing. Independent project, not affiliated with SAP or OpenAI.
Requires VS Code 1.137+ and Node.js 24+ on the MCP client host. The client must be able to run the bundled adapter in the same network environment as the VS Code extension host; hosted web sessions cannot connect directly.
Once published, install Workspace MCP from publisher hendrik101 from the
Marketplace
(extension ID hendrik101.vscode-workspace-mcp; select the pre-release channel
for the initial preview). Until the first publication, open a successful CI run on main,
download the workspace-mcp-vsix-Linux, -Windows or -macOS artifact and extract the ZIP. GitHub sign-in
is required. Alternatively, build the VSIX.
If using a downloaded or locally built VSIX, run Extensions: Install from VSIX
in the VS Code Command Palette and select
workspace-mcp.vsix.
Open and trust your workspace. Turn Files: Auto Save off before allowing agent edits; the bridge refuses edits when Auto Save is enabled.
Run Workspace MCP: Start. By default, it asks for write permission; dismissing the prompt keeps the bridge read-only. Editing and saving are separate operations.
Run Workspace MCP: Show Connection Details, select your client and copy the generated stdio configuration into its private user settings. It contains a secret token: never commit or share it. Restart the client connection.
Ask the agent to list workspace roots and read the active document.
Use Workspace MCP: Stop to disconnect. See client setup for client-specific instructions, write policies, ports and remote-host limitations. CI artifacts expire after 14 days. Versioned releases attach a VSIX and checksum to GitHub Releases and publish the same tested file to Marketplace after the owner pushes a release tag. The manual preview workflow remains available for inspecting a draft before the first public release.
Related MCP server: lsp-mcp
Requires Git and Node.js 24 LTS with npm (use the latest 24.x patch).
git clone https://github.com/hendrik-101/vscode-workspace-mcp.git
cd vscode-workspace-mcp
npm ci
npm run packageInstall the resulting artifacts/workspace-mcp.vsix using the steps above.
Tool | Behavior |
| Full workspace-folder URIs |
| Scoped active editor, selection and open text tabs |
| Entries through |
| Live text, version and dirty state; optional line range |
| Version-checked symbol bodies with bounded continuation |
| Bounded literal search with filters and continuation cursors |
| Version-checked text edits; leaves the buffer unsaved |
| Separate version-checked save; may trigger provider dialogs |
| Diagnostics already available in VS Code |
| Reveal a document and optional selection; preserve focus by default |
| Query installed workspace symbol providers; only admitted targets |
| Bounded document structure through installed language providers |
| Compare two workspace documents or a versioned proposed text snapshot |
| Preview provider formatting edits; optionally apply without saving |
| Wait for a diagnostic event or timeout; no analysis-completion guarantee |
| Query installed language providers |
| Preview provider text edits; no automatic application |
| search_commands | Discover runtime command IDs, manifest metadata and admission reasons |
| invoke_command | Invoke separately authorized, explicitly supported non-interactive zero-argument commands |
Positions are zero-based UTF-16; ranges are end-exclusive. Full URIs are required. No file creation/deletion/renaming, arbitrary commands or terminal tools. Direct commands require separate user authorization and an explicit exact-version non-interactive extension contract; existing extensions without that contract remain unsupported. No UI is controlled, and autonomous ADT login is not provided. Search reports truncation/errors: it is not an exhaustive SAP repository index.
See the tool reference for parameters and limits.
This server cannot be deployed
Start and manage Reason cloud coding agents, projects and sessions from any MCP client.
Read and write shared BitsWeave context, projects, tasks, and work sessions through MCP.
Lean 4 MCP server: compile, prove theorems, and formalize math with Mathlib.
The official Svelte MCP server providing docs and autofixing tools for Svelte development
