From 20eb59590ec17f6e262aa840a1c4437c028115c8 Mon Sep 17 00:00:00 2001 From: Kunal Babre Date: Fri, 11 Jul 2025 21:36:21 -0700 Subject: [PATCH 1/3] docs: Update VS Code installation instructions to use mcp.json - Replace outdated 'Preferences: Open Settings (JSON)' instructions - Add proper guidance for 'MCP: Open User Configuration' command - Update JSON examples to remove mcp wrapper key - Clarify user vs workspace configuration methods - Fixes issue with outdated documentation across all servers Affects: sequentialthinking, filesystem, memory, everything, git --- src/everything/README.md | 20 ++++++------ src/filesystem/README.md | 52 ++++++++++++++++---------------- src/git/README.md | 20 ++++++------ src/memory/README.md | 50 +++++++++++++++--------------- src/sequentialthinking/README.md | 46 ++++++++++++++-------------- 5 files changed, 96 insertions(+), 92 deletions(-) diff --git a/src/everything/README.md b/src/everything/README.md index 3ab3299a9c..7865128b03 100644 --- a/src/everything/README.md +++ b/src/everything/README.md @@ -160,22 +160,24 @@ For quick installation, use of of the one-click install buttons below... [![Install with Docker in VS Code](https://img.shields.io/badge/VS_Code-Docker-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=everything&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Feverything%22%5D%7D) [![Install with Docker in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Docker-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=everything&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Feverything%22%5D%7D&quality=insiders) -For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing `Ctrl + Shift + P` and typing `Preferences: Open User Settings (JSON)`. +For manual installation, you can configure the MCP server using one of these methods: -Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. +**Method 1: User Configuration (Recommended)** +Add the configuration to your user-level MCP configuration file. Open the Command Palette (`Ctrl + Shift + P`) and run `MCP: Open User Configuration`. This will open your user `mcp.json` file where you can add the server configuration. -> Note that the `mcp` key is not needed in the `.vscode/mcp.json` file. +**Method 2: Workspace Configuration** +Alternatively, you can add the configuration to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. + +> Note that the `servers` object should be at the root level in `mcp.json` files (no `mcp` wrapper key). #### NPX ```json { - "mcp": { - "servers": { - "everything": { - "command": "npx", - "args": ["-y", "@modelcontextprotocol/server-everything"] - } + "servers": { + "everything": { + "command": "npx", + "args": ["-y", "@modelcontextprotocol/server-everything"] } } } diff --git a/src/filesystem/README.md b/src/filesystem/README.md index cd6d0a9f06..3ba3950b5b 100644 --- a/src/filesystem/README.md +++ b/src/filesystem/README.md @@ -201,11 +201,15 @@ For quick installation, click the installation buttons below... [![Install with Docker in VS Code](https://img.shields.io/badge/VS_Code-Docker-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=filesystem&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22--mount%22%2C%22type%3Dbind%2Csrc%3D%24%7BworkspaceFolder%7D%2Cdst%3D%2Fprojects%2Fworkspace%22%2C%22mcp%2Ffilesystem%22%2C%22%2Fprojects%22%5D%7D) [![Install with Docker in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Docker-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=filesystem&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22--mount%22%2C%22type%3Dbind%2Csrc%3D%24%7BworkspaceFolder%7D%2Cdst%3D%2Fprojects%2Fworkspace%22%2C%22mcp%2Ffilesystem%22%2C%22%2Fprojects%22%5D%7D&quality=insiders) -For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing `Ctrl + Shift + P` and typing `Preferences: Open Settings (JSON)`. +For manual installation, you can configure the MCP server using one of these methods: -Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. +**Method 1: User Configuration (Recommended)** +Add the configuration to your user-level MCP configuration file. Open the Command Palette (`Ctrl + Shift + P`) and run `MCP: Open User Configuration`. This will open your user `mcp.json` file where you can add the server configuration. -> Note that the `mcp` key is not needed in the `.vscode/mcp.json` file. +**Method 2: Workspace Configuration** +Alternatively, you can add the configuration to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. + +> Note that the `servers` object should be at the root level in `mcp.json` files (no `mcp` wrapper key). You can provide sandboxed directories to the server by mounting them to `/projects`. Adding the `ro` flag will make the directory readonly by the server. @@ -214,19 +218,17 @@ Note: all directories must be mounted to `/projects` by default. ```json { - "mcp": { - "servers": { - "filesystem": { - "command": "docker", - "args": [ - "run", - "-i", - "--rm", - "--mount", "type=bind,src=${workspaceFolder},dst=/projects/workspace", - "mcp/filesystem", - "/projects" - ] - } + "servers": { + "filesystem": { + "command": "docker", + "args": [ + "run", + "-i", + "--rm", + "--mount", "type=bind,src=${workspaceFolder},dst=/projects/workspace", + "mcp/filesystem", + "/projects" + ] } } } @@ -236,16 +238,14 @@ Note: all directories must be mounted to `/projects` by default. ```json { - "mcp": { - "servers": { - "filesystem": { - "command": "npx", - "args": [ - "-y", - "@modelcontextprotocol/server-filesystem", - "${workspaceFolder}" - ] - } + "servers": { + "filesystem": { + "command": "npx", + "args": [ + "-y", + "@modelcontextprotocol/server-filesystem", + "${workspaceFolder}" + ] } } } diff --git a/src/git/README.md b/src/git/README.md index 8edf2124cc..7330b5fce8 100644 --- a/src/git/README.md +++ b/src/git/README.md @@ -173,20 +173,22 @@ For quick installation, use one of the one-click install buttons below... [![Install with Docker in VS Code](https://img.shields.io/badge/VS_Code-Docker-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=git&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22--rm%22%2C%22-i%22%2C%22--mount%22%2C%22type%3Dbind%2Csrc%3D%24%7BworkspaceFolder%7D%2Cdst%3D%2Fworkspace%22%2C%22mcp%2Fgit%22%5D%7D) [![Install with Docker in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Docker-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=git&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22--rm%22%2C%22-i%22%2C%22--mount%22%2C%22type%3Dbind%2Csrc%3D%24%7BworkspaceFolder%7D%2Cdst%3D%2Fworkspace%22%2C%22mcp%2Fgit%22%5D%7D&quality=insiders) -For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing `Ctrl + Shift + P` and typing `Preferences: Open Settings (JSON)`. +For manual installation, you can configure the MCP server using one of these methods: -Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. +**Method 1: User Configuration (Recommended)** +Add the configuration to your user-level MCP configuration file. Open the Command Palette (`Ctrl + Shift + P`) and run `MCP: Open User Configuration`. This will open your user `mcp.json` file where you can add the server configuration. -> Note that the `mcp` key is not needed in the `.vscode/mcp.json` file. +**Method 2: Workspace Configuration** +Alternatively, you can add the configuration to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. + +> Note that the `servers` object should be at the root level in `mcp.json` files (no `mcp` wrapper key). ```json { - "mcp": { - "servers": { - "git": { - "command": "uvx", - "args": ["mcp-server-git"] - } + "servers": { + "git": { + "command": "uvx", + "args": ["mcp-server-git"] } } } diff --git a/src/memory/README.md b/src/memory/README.md index 5b18d8413c..7f6f5d970c 100644 --- a/src/memory/README.md +++ b/src/memory/README.md @@ -190,25 +190,27 @@ For quick installation, use one of the one-click installation buttons below: [![Install with Docker in VS Code](https://img.shields.io/badge/VS_Code-Docker-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=memory&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22-v%22%2C%22claude-memory%3A%2Fapp%2Fdist%22%2C%22--rm%22%2C%22mcp%2Fmemory%22%5D%7D) [![Install with Docker in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Docker-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=memory&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22-v%22%2C%22claude-memory%3A%2Fapp%2Fdist%22%2C%22--rm%22%2C%22mcp%2Fmemory%22%5D%7D&quality=insiders) -For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing `Ctrl + Shift + P` and typing `Preferences: Open Settings (JSON)`. +For manual installation, you can configure the MCP server using one of these methods: -Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. +**Method 1: User Configuration (Recommended)** +Add the configuration to your user-level MCP configuration file. Open the Command Palette (`Ctrl + Shift + P`) and run `MCP: Open User Configuration`. This will open your user `mcp.json` file where you can add the server configuration. -> Note that the `mcp` key is not needed in the `.vscode/mcp.json` file. +**Method 2: Workspace Configuration** +Alternatively, you can add the configuration to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. + +> Note that the `servers` object should be at the root level in `mcp.json` files (no `mcp` wrapper key). #### NPX ```json { - "mcp": { - "servers": { - "memory": { - "command": "npx", - "args": [ - "-y", - "@modelcontextprotocol/server-memory" - ] - } + "servers": { + "memory": { + "command": "npx", + "args": [ + "-y", + "@modelcontextprotocol/server-memory" + ] } } } @@ -218,19 +220,17 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace ```json { - "mcp": { - "servers": { - "memory": { - "command": "docker", - "args": [ - "run", - "-i", - "-v", - "claude-memory:/app/dist", - "--rm", - "mcp/memory" - ] - } + "servers": { + "memory": { + "command": "docker", + "args": [ + "run", + "-i", + "-v", + "claude-memory:/app/dist", + "--rm", + "mcp/memory" + ] } } } diff --git a/src/sequentialthinking/README.md b/src/sequentialthinking/README.md index fd90b9b111..3be6b3c654 100644 --- a/src/sequentialthinking/README.md +++ b/src/sequentialthinking/README.md @@ -88,25 +88,27 @@ For quick installation, click one of the installation buttons below... [![Install with Docker in VS Code](https://img.shields.io/badge/VS_Code-Docker-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=sequentialthinking&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22--rm%22%2C%22-i%22%2C%22mcp%2Fsequentialthinking%22%5D%7D) [![Install with Docker in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Docker-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=sequentialthinking&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22--rm%22%2C%22-i%22%2C%22mcp%2Fsequentialthinking%22%5D%7D&quality=insiders) -For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing `Ctrl + Shift + P` and typing `Preferences: Open Settings (JSON)`. +For manual installation, you can configure the MCP server using one of these methods: -Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. +**Method 1: User Configuration (Recommended)** +Add the configuration to your user-level MCP configuration file. Open the Command Palette (`Ctrl + Shift + P`) and run `MCP: Open User Configuration`. This will open your user `mcp.json` file where you can add the server configuration. -> Note that the `mcp` key is not needed in the `.vscode/mcp.json` file. +**Method 2: Workspace Configuration** +Alternatively, you can add the configuration to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. + +> Note that the `servers` object should be at the root level in `mcp.json` files (no `mcp` wrapper key). For NPX installation: ```json { - "mcp": { - "servers": { - "sequential-thinking": { - "command": "npx", - "args": [ - "-y", - "@modelcontextprotocol/server-sequential-thinking" - ] - } + "servers": { + "sequential-thinking": { + "command": "npx", + "args": [ + "-y", + "@modelcontextprotocol/server-sequential-thinking" + ] } } } @@ -116,17 +118,15 @@ For Docker installation: ```json { - "mcp": { - "servers": { - "sequential-thinking": { - "command": "docker", - "args": [ - "run", - "--rm", - "-i", - "mcp/sequentialthinking" - ] - } + "servers": { + "sequential-thinking": { + "command": "docker", + "args": [ + "run", + "--rm", + "-i", + "mcp/sequentialthinking" + ] } } } From 95a72b792f9945ec061d325ff3c934dcb478d4d8 Mon Sep 17 00:00:00 2001 From: Kunal Babre Date: Fri, 11 Jul 2025 22:45:10 -0700 Subject: [PATCH 2/3] docs: Add reference to official VS Code MCP documentation - Add link to official VS Code MCP documentation in all server READMEs - Enhances existing VS Code installation instructions with authoritative reference - Provides users with comprehensive documentation for advanced configuration - Complements the existing two-method approach with additional resources Affects: everything, filesystem, git, memory, sequentialthinking --- src/everything/README.md | 2 ++ src/filesystem/README.md | 2 ++ src/git/README.md | 2 ++ src/memory/README.md | 2 ++ src/sequentialthinking/README.md | 2 ++ 5 files changed, 10 insertions(+) diff --git a/src/everything/README.md b/src/everything/README.md index 7865128b03..a6aef9a109 100644 --- a/src/everything/README.md +++ b/src/everything/README.md @@ -169,6 +169,8 @@ Add the configuration to your user-level MCP configuration file. Open the Comman Alternatively, you can add the configuration to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. > Note that the `servers` object should be at the root level in `mcp.json` files (no `mcp` wrapper key). +> +> For more details about MCP configuration in VS Code, see the [official VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/mcp). #### NPX diff --git a/src/filesystem/README.md b/src/filesystem/README.md index 3ba3950b5b..0df9bf8952 100644 --- a/src/filesystem/README.md +++ b/src/filesystem/README.md @@ -210,6 +210,8 @@ Add the configuration to your user-level MCP configuration file. Open the Comman Alternatively, you can add the configuration to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. > Note that the `servers` object should be at the root level in `mcp.json` files (no `mcp` wrapper key). +> +> For more details about MCP configuration in VS Code, see the [official VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/mcp). You can provide sandboxed directories to the server by mounting them to `/projects`. Adding the `ro` flag will make the directory readonly by the server. diff --git a/src/git/README.md b/src/git/README.md index 7330b5fce8..3a4f06f729 100644 --- a/src/git/README.md +++ b/src/git/README.md @@ -182,6 +182,8 @@ Add the configuration to your user-level MCP configuration file. Open the Comman Alternatively, you can add the configuration to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. > Note that the `servers` object should be at the root level in `mcp.json` files (no `mcp` wrapper key). +> +> For more details about MCP configuration in VS Code, see the [official VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/mcp). ```json { diff --git a/src/memory/README.md b/src/memory/README.md index 7f6f5d970c..3e736dcbb0 100644 --- a/src/memory/README.md +++ b/src/memory/README.md @@ -199,6 +199,8 @@ Add the configuration to your user-level MCP configuration file. Open the Comman Alternatively, you can add the configuration to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. > Note that the `servers` object should be at the root level in `mcp.json` files (no `mcp` wrapper key). +> +> For more details about MCP configuration in VS Code, see the [official VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/mcp). #### NPX diff --git a/src/sequentialthinking/README.md b/src/sequentialthinking/README.md index 3be6b3c654..e36d31f8d2 100644 --- a/src/sequentialthinking/README.md +++ b/src/sequentialthinking/README.md @@ -97,6 +97,8 @@ Add the configuration to your user-level MCP configuration file. Open the Comman Alternatively, you can add the configuration to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. > Note that the `servers` object should be at the root level in `mcp.json` files (no `mcp` wrapper key). +> +> For more details about MCP configuration in VS Code, see the [official VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/mcp). For NPX installation: From 55a36ad0dd9ba2ca4d42cbfc44b3d79c2193439d Mon Sep 17 00:00:00 2001 From: Kunal Babre Date: Fri, 11 Jul 2025 22:53:13 -0700 Subject: [PATCH 3/3] docs: Clean up VS Code installation instructions - Remove unnecessary explanatory note about JSON format - JSON examples already demonstrate the correct format clearly - Streamlines documentation to focus on essential information - Maintains reference to official VS Code MCP documentation The removed note was redundant since both configuration methods use identical JSON structure shown in the examples. --- src/everything/README.md | 2 -- src/filesystem/README.md | 2 -- src/git/README.md | 2 -- src/memory/README.md | 2 -- src/sequentialthinking/README.md | 2 -- 5 files changed, 10 deletions(-) diff --git a/src/everything/README.md b/src/everything/README.md index a6aef9a109..f8e35c14f9 100644 --- a/src/everything/README.md +++ b/src/everything/README.md @@ -168,8 +168,6 @@ Add the configuration to your user-level MCP configuration file. Open the Comman **Method 2: Workspace Configuration** Alternatively, you can add the configuration to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. -> Note that the `servers` object should be at the root level in `mcp.json` files (no `mcp` wrapper key). -> > For more details about MCP configuration in VS Code, see the [official VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/mcp). #### NPX diff --git a/src/filesystem/README.md b/src/filesystem/README.md index 0df9bf8952..2ecf94e719 100644 --- a/src/filesystem/README.md +++ b/src/filesystem/README.md @@ -209,8 +209,6 @@ Add the configuration to your user-level MCP configuration file. Open the Comman **Method 2: Workspace Configuration** Alternatively, you can add the configuration to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. -> Note that the `servers` object should be at the root level in `mcp.json` files (no `mcp` wrapper key). -> > For more details about MCP configuration in VS Code, see the [official VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/mcp). You can provide sandboxed directories to the server by mounting them to `/projects`. Adding the `ro` flag will make the directory readonly by the server. diff --git a/src/git/README.md b/src/git/README.md index 3a4f06f729..35ed426805 100644 --- a/src/git/README.md +++ b/src/git/README.md @@ -181,8 +181,6 @@ Add the configuration to your user-level MCP configuration file. Open the Comman **Method 2: Workspace Configuration** Alternatively, you can add the configuration to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. -> Note that the `servers` object should be at the root level in `mcp.json` files (no `mcp` wrapper key). -> > For more details about MCP configuration in VS Code, see the [official VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/mcp). ```json diff --git a/src/memory/README.md b/src/memory/README.md index 3e736dcbb0..3a4b2a20d1 100644 --- a/src/memory/README.md +++ b/src/memory/README.md @@ -198,8 +198,6 @@ Add the configuration to your user-level MCP configuration file. Open the Comman **Method 2: Workspace Configuration** Alternatively, you can add the configuration to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. -> Note that the `servers` object should be at the root level in `mcp.json` files (no `mcp` wrapper key). -> > For more details about MCP configuration in VS Code, see the [official VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/mcp). #### NPX diff --git a/src/sequentialthinking/README.md b/src/sequentialthinking/README.md index e36d31f8d2..c3886a9b44 100644 --- a/src/sequentialthinking/README.md +++ b/src/sequentialthinking/README.md @@ -96,8 +96,6 @@ Add the configuration to your user-level MCP configuration file. Open the Comman **Method 2: Workspace Configuration** Alternatively, you can add the configuration to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others. -> Note that the `servers` object should be at the root level in `mcp.json` files (no `mcp` wrapper key). -> > For more details about MCP configuration in VS Code, see the [official VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/mcp). For NPX installation: