diff --git a/src/aws-kb-retrieval-server/README.md b/src/aws-kb-retrieval-server/README.md
index 07941eb9..6a91035d 100644
--- a/src/aws-kb-retrieval-server/README.md
+++ b/src/aws-kb-retrieval-server/README.md
@@ -23,6 +23,55 @@ An MCP server implementation for retrieving information from the AWS Knowledge B
1. Obtain AWS access key ID, secret access key, and region from the AWS Management Console.
2. Ensure these credentials have appropriate permissions for Bedrock Agent Runtime operations.
+### Usage with Claude Desktop
+
+Add this to your `claude_desktop_config.json`:
+
+#### Docker
+
+```json
+{
+ "mcpServers": {
+ "aws-kb-retrieval": {
+ "command": "docker",
+ "args": [
+ "run",
+ "-i",
+ "--rm",
+ "-e",
+ "AWS_ACCESS_KEY_ID",
+ "-e",
+ "AWS_SECRET_ACCESS_KEY",
+ "-e",
+ "AWS_REGION",
+ "mcp/aws-kb-retrieval-server"
+ ],
+ "env": {
+ "AWS_ACCESS_KEY_ID": "YOUR_ACCESS_KEY_HERE",
+ "AWS_SECRET_ACCESS_KEY": "YOUR_SECRET_ACCESS_KEY_HERE",
+ "AWS_REGION": "YOUR_AWS_REGION_HERE"
+ }
+ }
+ }
+}
+```
+
+```json
+{
+ "mcpServers": {
+ "aws-kb-retrieval": {
+ "command": "npx",
+ "args": ["-y", "@modelcontextprotocol/server-aws-kb-retrieval"],
+ "env": {
+ "AWS_ACCESS_KEY_ID": "YOUR_ACCESS_KEY_HERE",
+ "AWS_SECRET_ACCESS_KEY": "YOUR_SECRET_ACCESS_KEY_HERE",
+ "AWS_REGION": "YOUR_AWS_REGION_HERE"
+ }
+ }
+ }
+}
+```
+
### Usage with VS Code
For quick installation, use one of the one-click install buttons below...
@@ -115,57 +164,14 @@ For Docker installation:
}
```
-### Usage with Claude Desktop
-
-Add this to your `claude_desktop_config.json`:
-
-#### Docker
-
-```json
-{
- "mcpServers": {
- "aws-kb-retrieval": {
- "command": "docker",
- "args": [ "run", "-i", "--rm", "-e", "AWS_ACCESS_KEY_ID", "-e", "AWS_SECRET_ACCESS_KEY", "-e", "AWS_REGION", "mcp/aws-kb-retrieval-server" ],
- "env": {
- "AWS_ACCESS_KEY_ID": "YOUR_ACCESS_KEY_HERE",
- "AWS_SECRET_ACCESS_KEY": "YOUR_SECRET_ACCESS_KEY_HERE",
- "AWS_REGION": "YOUR_AWS_REGION_HERE"
- }
- }
- }
-}
-```
-
-```json
-{
- "mcpServers": {
- "aws-kb-retrieval": {
- "command": "npx",
- "args": [
- "-y",
- "@modelcontextprotocol/server-aws-kb-retrieval"
- ],
- "env": {
- "AWS_ACCESS_KEY_ID": "YOUR_ACCESS_KEY_HERE",
- "AWS_SECRET_ACCESS_KEY": "YOUR_SECRET_ACCESS_KEY_HERE",
- "AWS_REGION": "YOUR_AWS_REGION_HERE"
- }
- }
- }
-}
-```
-
## Building
-Docker:
+Docker:
```sh
-docker build -t mcp/aws-kb-retrieval -f src/aws-kb-retrieval-server/Dockerfile .
+docker build -t mcp/aws-kb-retrieval -f src/aws-kb-retrieval-server/Dockerfile .
```
## License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
-
-This README assumes that your server package is named `@modelcontextprotocol/server-aws-kb-retrieval`. Adjust the package name and installation details if they differ in your setup. Also, ensure that your server script is correctly built and that all dependencies are properly managed in your `package.json`.
diff --git a/src/brave-search/README.md b/src/brave-search/README.md
index c9c7b284..815c5af8 100644
--- a/src/brave-search/README.md
+++ b/src/brave-search/README.md
@@ -80,7 +80,7 @@ Add this to your `claude_desktop_config.json`:
}
```
-### VS Code
+### Usage with VS Code
For quick installation, use the one-click installation buttons below...
@@ -94,32 +94,6 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
> Note that the `mcp` key is not needed in the `.vscode/mcp.json` file.
-#### NPX
-
-```json
-{
- "mcp": {
- "inputs": [
- {
- "type": "promptString",
- "id": "brave_api_key",
- "description": "Brave Search API Key",
- "password": true
- }
- ],
- "servers": {
- "brave-search": {
- "command": "npx",
- "args": ["-y", "@modelcontextprotocol/server-brave-search"],
- "env": {
- "BRAVE_API_KEY": "${input:brave_api_key}"
- }
- }
- }
- }
-}
-```
-
#### Docker
```json
@@ -153,6 +127,32 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
}
```
+#### NPX
+
+```json
+{
+ "mcp": {
+ "inputs": [
+ {
+ "type": "promptString",
+ "id": "brave_api_key",
+ "description": "Brave Search API Key",
+ "password": true
+ }
+ ],
+ "servers": {
+ "brave-search": {
+ "command": "npx",
+ "args": ["-y", "@modelcontextprotocol/server-brave-search"],
+ "env": {
+ "BRAVE_API_KEY": "${input:brave_api_key}"
+ }
+ }
+ }
+ }
+}
+```
+
## Build
Docker build:
diff --git a/src/everart/README.md b/src/everart/README.md
index d7e5a5f5..22045652 100644
--- a/src/everart/README.md
+++ b/src/everart/README.md
@@ -11,6 +11,42 @@ export EVERART_API_KEY=your_key_here
## Config
+### Usage with Claude Desktop
+
+Add to Claude Desktop config:
+
+#### Docker
+
+```json
+{
+ "mcpServers": {
+ "everart": {
+ "command": "docker",
+ "args": ["run", "-i", "--rm", "-e", "EVERART_API_KEY", "mcp/everart"],
+ "env": {
+ "EVERART_API_KEY": "your_key_here"
+ }
+ }
+ }
+}
+```
+
+#### NPX
+
+```json
+{
+ "mcpServers": {
+ "everart": {
+ "command": "npx",
+ "args": ["-y", "@modelcontextprotocol/server-everart"],
+ "env": {
+ "EVERART_API_KEY": "your_key_here"
+ }
+ }
+ }
+}
+```
+
### Usage with VS Code
For quick installation, use the one-click installation buttons below...
@@ -25,32 +61,6 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
> Note that the `mcp` key is needed when using the `mcp.json` file.
-#### NPX
-
-```json
-{
- "mcp": {
- "inputs": [
- {
- "type": "promptString",
- "id": "everart_api_key",
- "description": "EverArt API Key",
- "password": true
- }
- ],
- "servers": {
- "everart": {
- "command": "npx",
- "args": ["-y", "@modelcontextprotocol/server-everart"],
- "env": {
- "EVERART_API_KEY": "${input:everart_api_key}"
- }
- }
- }
- }
-}
-```
-
#### Docker
```json
@@ -77,36 +87,26 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
}
```
-### Usage with Claude Desktop
-
-Add to Claude Desktop config:
-
-### Docker
+#### NPX
```json
{
- "mcpServers": {
- "everart": {
- "command": "docker",
- "args": ["run", "-i", "--rm", "-e", "EVERART_API_KEY", "mcp/everart"],
- "env": {
- "EVERART_API_KEY": "your_key_here"
+ "mcp": {
+ "inputs": [
+ {
+ "type": "promptString",
+ "id": "everart_api_key",
+ "description": "EverArt API Key",
+ "password": true
}
- }
- }
-}
-```
-
-### NPX
-
-```json
-{
- "mcpServers": {
- "everart": {
- "command": "npx",
- "args": ["-y", "@modelcontextprotocol/server-everart"],
- "env": {
- "EVERART_API_KEY": "your_key_here"
+ ],
+ "servers": {
+ "everart": {
+ "command": "npx",
+ "args": ["-y", "@modelcontextprotocol/server-everart"],
+ "env": {
+ "EVERART_API_KEY": "${input:everart_api_key}"
+ }
}
}
}
@@ -161,7 +161,7 @@ The image has been opened in your default browser.
Generation details:
- Model: 7000
- Prompt: "A cat sitting elegantly"
-- Image URL: https://storage.googleapis.com/...
+- Image URL: https://storage.googleapis.com/...
You can also click the URL above to view the image again.
```
diff --git a/src/everything/README.md b/src/everything/README.md
index 821df6c0..236ac596 100644
--- a/src/everything/README.md
+++ b/src/everything/README.md
@@ -126,6 +126,24 @@ The server sends random-leveled log messages every 15 seconds, e.g.:
}
```
+## Usage with Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+ "mcpServers": {
+ "everything": {
+ "command": "npx",
+ "args": [
+ "-y",
+ "@modelcontextprotocol/server-everything"
+ ]
+ }
+ }
+}
+```
+
## Usage with VS Code
For quick installation, use of of the one-click install buttons below...
@@ -154,21 +172,3 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
}
}
```
-
-## Usage with Claude Desktop
-
-Add to your `claude_desktop_config.json`:
-
-```json
-{
- "mcpServers": {
- "everything": {
- "command": "npx",
- "args": [
- "-y",
- "@modelcontextprotocol/server-everything"
- ]
- }
- }
-}
-```
diff --git a/src/fetch/README.md b/src/fetch/README.md
index 7afac4cc..0b02fcf9 100644
--- a/src/fetch/README.md
+++ b/src/fetch/README.md
@@ -44,7 +44,50 @@ python -m mcp_server_fetch
## Configuration
-### Usage with VS Code
+### Configure for Claude.app
+
+Add to your Claude settings:
+
+
+Using uvx
+
+```json
+"mcpServers": {
+ "fetch": {
+ "command": "uvx",
+ "args": ["mcp-server-fetch"]
+ }
+}
+```
+
+
+
+Using docker
+
+```json
+"mcpServers": {
+ "fetch": {
+ "command": "docker",
+ "args": ["run", "-i", "--rm", "mcp/fetch"]
+ }
+}
+```
+
+
+
+Using pip installation
+
+```json
+"mcpServers": {
+ "fetch": {
+ "command": "python",
+ "args": ["-m", "mcp_server_fetch"]
+ }
+}
+```
+
+
+### Configure for VS Code
For quick installation, use one of the one-click install buttons below...
@@ -92,49 +135,6 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
```
-### Configure for Claude.app
-
-Add to your Claude settings:
-
-
-Using uvx
-
-```json
-"mcpServers": {
- "fetch": {
- "command": "uvx",
- "args": ["mcp-server-fetch"]
- }
-}
-```
-
-
-
-Using docker
-
-```json
-"mcpServers": {
- "fetch": {
- "command": "docker",
- "args": ["run", "-i", "--rm", "mcp/fetch"]
- }
-}
-```
-
-
-
-Using pip installation
-
-```json
-"mcpServers": {
- "fetch": {
- "command": "python",
- "args": ["-m", "mcp_server_fetch"]
- }
-}
-```
-
-
### Customization - robots.txt
By default, the server will obey a websites robots.txt file if the request came from the model (via a tool), but not if
diff --git a/src/filesystem/README.md b/src/filesystem/README.md
index 960fe44b..d1621d1e 100644
--- a/src/filesystem/README.md
+++ b/src/filesystem/README.md
@@ -157,25 +157,10 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
> Note that the `mcp` key is not needed in the `.vscode/mcp.json` file.
-```json
-{
- "mcp": {
- "servers": {
- "filesystem": {
- "command": "npx",
- "args": [
- "-y",
- "@modelcontextprotocol/server-filesystem",
- "${workspaceFolder}"
- ]
- }
- }
- }
-}
-```
+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.
-For Docker installation:
-Note: all directories must be mounted to `/projects` by default.
+### Docker
+Note: all directories must be mounted to `/projects` by default.
```json
{
@@ -195,8 +180,25 @@ Note: all directories must be mounted to `/projects` by default.
}
}
}
+```
-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.
+### NPX
+
+```json
+{
+ "mcp": {
+ "servers": {
+ "filesystem": {
+ "command": "npx",
+ "args": [
+ "-y",
+ "@modelcontextprotocol/server-filesystem",
+ "${workspaceFolder}"
+ ]
+ }
+ }
+ }
+}
```
## Build
diff --git a/src/github/README.md b/src/github/README.md
index 66e94c03..d1456be2 100644
--- a/src/github/README.md
+++ b/src/github/README.md
@@ -315,6 +315,50 @@ For detailed search syntax, see [GitHub's searching documentation](https://docs.
- Alternatively, if working only with public repositories, select only the `public_repo` scope
- Copy the generated token
+### Usage with Claude Desktop
+To use this with Claude Desktop, add the following to your `claude_desktop_config.json`:
+
+#### Docker
+```json
+{
+ "mcpServers": {
+ "github": {
+ "command": "docker",
+ "args": [
+ "run",
+ "-i",
+ "--rm",
+ "-e",
+ "GITHUB_PERSONAL_ACCESS_TOKEN",
+ "mcp/github"
+ ],
+ "env": {
+ "GITHUB_PERSONAL_ACCESS_TOKEN": ""
+ }
+ }
+ }
+}
+```
+
+#### NPX
+
+```json
+{
+ "mcpServers": {
+ "github": {
+ "command": "npx",
+ "args": [
+ "-y",
+ "@modelcontextprotocol/server-github"
+ ],
+ "env": {
+ "GITHUB_PERSONAL_ACCESS_TOKEN": ""
+ }
+ }
+ }
+}
+```
+
### Usage with VS Code
For quick installation, use one of the installation buttons below:
@@ -330,6 +374,34 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
> Note that the `mcp` key is not needed in the `.vscode/mcp.json` file.
+#### Docker
+
+```json
+{
+ "mcp": {
+ "inputs": [
+ {
+ "type": "promptString",
+ "id": "github_token",
+ "description": "GitHub Personal Access Token",
+ "password": true
+ }
+ ],
+ "servers": {
+ "github": {
+ "command": "docker",
+ "args": ["run", "-i", "--rm", "mcp/github"],
+ "env": {
+ "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
+ }
+ }
+ }
+ }
+}
+```
+
+#### NPX
+
```json
{
"mcp": {
@@ -357,76 +429,6 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
}
```
-For Docker installation:
-
-```json
-{
- "mcp": {
- "inputs": [
- {
- "type": "promptString",
- "id": "github_token",
- "description": "GitHub Personal Access Token",
- "password": true
- }
- ],
- "servers": {
- "github": {
- "command": "docker",
- "args": ["run", "-i", "--rm", "mcp/github"],
- "env": {
- "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
- }
- }
- }
- }
-}
-```
-
-### Usage with Claude Desktop
-To use this with Claude Desktop, add the following to your `claude_desktop_config.json`:
-
-#### Docker
-```json
-{
- "mcpServers": {
- "github": {
- "command": "docker",
- "args": [
- "run",
- "-i",
- "--rm",
- "-e",
- "GITHUB_PERSONAL_ACCESS_TOKEN",
- "mcp/github"
- ],
- "env": {
- "GITHUB_PERSONAL_ACCESS_TOKEN": ""
- }
- }
- }
-}
-```
-
-### NPX
-
-```json
-{
- "mcpServers": {
- "github": {
- "command": "npx",
- "args": [
- "-y",
- "@modelcontextprotocol/server-github"
- ],
- "env": {
- "GITHUB_PERSONAL_ACCESS_TOKEN": ""
- }
- }
- }
-}
-```
-
## Build
Docker build:
diff --git a/src/gitlab/README.md b/src/gitlab/README.md
index a187d26c..2687f6ed 100644
--- a/src/gitlab/README.md
+++ b/src/gitlab/README.md
@@ -106,6 +106,54 @@ MCP Server for the GitLab API, enabling project management, file operations, and
- `read_repository` and `write_repository` for repository operations
- Create the token and save it securely
+### Usage with Claude Desktop
+Add the following to your `claude_desktop_config.json`:
+
+#### Docker
+```json
+{
+ "mcpServers": {
+ "gitlab": {
+ "command": "docker",
+ "args": [
+ "run",
+ "--rm",
+ "-i",
+ "-e",
+ "GITLAB_PERSONAL_ACCESS_TOKEN",
+ "-e",
+ "GITLAB_API_URL",
+ "mcp/gitlab"
+ ],
+ "env": {
+ "GITLAB_PERSONAL_ACCESS_TOKEN": "",
+ "GITLAB_API_URL": "https://gitlab.com/api/v4" // Optional, for self-hosted instances
+ }
+ }
+ }
+}
+```
+
+#### NPX
+
+```json
+{
+ "mcpServers": {
+ "gitlab": {
+ "command": "npx",
+ "args": [
+ "-y",
+ "@modelcontextprotocol/server-gitlab"
+ ],
+ "env": {
+ "GITLAB_PERSONAL_ACCESS_TOKEN": "",
+ "GITLAB_API_URL": "https://gitlab.com/api/v4" // Optional, for self-hosted instances
+ }
+ }
+ }
+}
+```
+
### Usage with VS Code
For quick installation, use one of the one-click installation buttons below...
@@ -120,43 +168,7 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
> Note that the `mcp` key is not needed in the `.vscode/mcp.json` file.
-For NPX installation:
-
-```json
-{
- "mcp": {
- "inputs": [
- {
- "type": "promptString",
- "id": "gitlab_token",
- "description": "GitLab Personal Access Token",
- "password": true
- },
- {
- "type": "promptString",
- "id": "gitlab_url",
- "description": "GitLab API URL (optional)",
- "default": "https://gitlab.com/api/v4"
- }
- ],
- "servers": {
- "gitlab": {
- "command": "npx",
- "args": [
- "-y",
- "@modelcontextprotocol/server-gitlab"
- ],
- "env": {
- "GITLAB_PERSONAL_ACCESS_TOKEN": "${input:gitlab_token}",
- "GITLAB_API_URL": "${input:gitlab_url}"
- }
- }
- }
- }
-}
-```
-
-For Docker installation:
+#### Docker
```json
{
@@ -194,48 +206,36 @@ For Docker installation:
}
```
-### Usage with Claude Desktop
-Add the following to your `claude_desktop_config.json`:
+#### NPX
-#### Docker
```json
{
- "mcpServers": {
- "gitlab": {
- "command": "docker",
- "args": [
- "run",
- "--rm",
- "-i",
- "-e",
- "GITLAB_PERSONAL_ACCESS_TOKEN",
- "-e",
- "GITLAB_API_URL",
- "mcp/gitlab"
- ],
- "env": {
- "GITLAB_PERSONAL_ACCESS_TOKEN": "",
- "GITLAB_API_URL": "https://gitlab.com/api/v4" // Optional, for self-hosted instances
+ "mcp": {
+ "inputs": [
+ {
+ "type": "promptString",
+ "id": "gitlab_token",
+ "description": "GitLab Personal Access Token",
+ "password": true
+ },
+ {
+ "type": "promptString",
+ "id": "gitlab_url",
+ "description": "GitLab API URL (optional)",
+ "default": "https://gitlab.com/api/v4"
}
- }
- }
-}
-```
-
-### NPX
-
-```json
-{
- "mcpServers": {
- "gitlab": {
- "command": "npx",
- "args": [
- "-y",
- "@modelcontextprotocol/server-gitlab"
- ],
- "env": {
- "GITLAB_PERSONAL_ACCESS_TOKEN": "",
- "GITLAB_API_URL": "https://gitlab.com/api/v4" // Optional, for self-hosted instances
+ ],
+ "servers": {
+ "gitlab": {
+ "command": "npx",
+ "args": [
+ "-y",
+ "@modelcontextprotocol/server-gitlab"
+ ],
+ "env": {
+ "GITLAB_PERSONAL_ACCESS_TOKEN": "${input:gitlab_token}",
+ "GITLAB_API_URL": "${input:gitlab_url}"
+ }
}
}
}
diff --git a/src/google-maps/README.md b/src/google-maps/README.md
index 6652ab06..54f0838f 100644
--- a/src/google-maps/README.md
+++ b/src/google-maps/README.md
@@ -5,11 +5,13 @@ MCP Server for the Google Maps API.
## Tools
1. `maps_geocode`
+
- Convert address to coordinates
- Input: `address` (string)
- Returns: location, formatted_address, place_id
2. `maps_reverse_geocode`
+
- Convert coordinates to address
- Inputs:
- `latitude` (number)
@@ -17,6 +19,7 @@ MCP Server for the Google Maps API.
- Returns: formatted_address, place_id, address_components
3. `maps_search_places`
+
- Search for places using text query
- Inputs:
- `query` (string)
@@ -25,11 +28,13 @@ MCP Server for the Google Maps API.
- Returns: array of places with names, addresses, locations
4. `maps_place_details`
+
- Get detailed information about a place
- Input: `place_id` (string)
- Returns: name, address, contact info, ratings, reviews, opening hours
5. `maps_distance_matrix`
+
- Calculate distances and times between points
- Inputs:
- `origins` (string[])
@@ -38,6 +43,7 @@ MCP Server for the Google Maps API.
- Returns: distances and durations matrix
6. `maps_elevation`
+
- Get elevation data for locations
- Input: `locations` (array of {latitude, longitude})
- Returns: elevation data for each point
@@ -53,8 +59,52 @@ MCP Server for the Google Maps API.
## Setup
### API Key
+
Get a Google Maps API key by following the instructions [here](https://developers.google.com/maps/documentation/javascript/get-api-key#create-api-keys).
+### Usage with Claude Desktop
+
+Add the following to your `claude_desktop_config.json`:
+
+#### Docker
+
+```json
+{
+ "mcpServers": {
+ "google-maps": {
+ "command": "docker",
+ "args": [
+ "run",
+ "-i",
+ "--rm",
+ "-e",
+ "GOOGLE_MAPS_API_KEY",
+ "mcp/google-maps"
+ ],
+ "env": {
+ "GOOGLE_MAPS_API_KEY": ""
+ }
+ }
+ }
+}
+```
+
+### NPX
+
+```json
+{
+ "mcpServers": {
+ "google-maps": {
+ "command": "npx",
+ "args": ["-y", "@modelcontextprotocol/server-google-maps"],
+ "env": {
+ "GOOGLE_MAPS_API_KEY": ""
+ }
+ }
+ }
+}
+```
+
### Usage with VS Code
For quick installation, use one of the one-click install buttons below...
@@ -63,7 +113,6 @@ For quick installation, use one of the one-click install buttons below...
[](https://insiders.vscode.dev/redirect/mcp/install?name=google-maps&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22maps_api_key%22%2C%22description%22%3A%22Google%20Maps%20API%20Key%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Fgoogle-maps%22%5D%2C%22env%22%3A%7B%22GOOGLE_MAPS_API_KEY%22%3A%22%24%7Binput%3Amaps_api_key%7D%22%7D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=google-maps&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22maps_api_key%22%2C%22description%22%3A%22Google%20Maps%20API%20Key%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Fgoogle-maps%22%5D%2C%22env%22%3A%7B%22GOOGLE_MAPS_API_KEY%22%3A%22%24%7Binput%3Amaps_api_key%7D%22%7D%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)`.
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.
@@ -120,52 +169,6 @@ For Docker installation:
}
```
-### Usage with Claude Desktop
-
-Add the following to your `claude_desktop_config.json`:
-
-#### Docker
-
-```json
-{
- "mcpServers": {
- "google-maps": {
- "command": "docker",
- "args": [
- "run",
- "-i",
- "--rm",
- "-e",
- "GOOGLE_MAPS_API_KEY",
- "mcp/google-maps"
- ],
- "env": {
- "GOOGLE_MAPS_API_KEY": ""
- }
- }
- }
-}
-```
-
-### NPX
-
-```json
-{
- "mcpServers": {
- "google-maps": {
- "command": "npx",
- "args": [
- "-y",
- "@modelcontextprotocol/server-google-maps"
- ],
- "env": {
- "GOOGLE_MAPS_API_KEY": ""
- }
- }
- }
-}
-```
-
## Build
Docker build:
diff --git a/src/memory/README.md b/src/memory/README.md
index 072f37aa..5b131ff6 100644
--- a/src/memory/README.md
+++ b/src/memory/README.md
@@ -197,6 +197,7 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
> Note that the `mcp` key is not needed in the `.vscode/mcp.json` file.
#### NPX
+
```json
{
"mcp": {
@@ -214,6 +215,7 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
```
#### Docker
+
```json
{
"mcp": {
diff --git a/src/postgres/README.md b/src/postgres/README.md
index 2b0bdcd5..cc92521a 100644
--- a/src/postgres/README.md
+++ b/src/postgres/README.md
@@ -22,76 +22,6 @@ The server provides schema information for each table in the database:
## Configuration
-### Usage with VS Code
-
-For quick installation, use one of the one-click install buttons below...
-
-[](https://insiders.vscode.dev/redirect/mcp/install?name=postgres&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22pg_url%22%2C%22description%22%3A%22PostgreSQL%20URL%20(e.g.%20postgresql%3A%2F%2Fuser%3Apass%40localhost%3A5432%2Fmydb)%22%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-postgres%22%2C%22%24%7Binput%3Apg_url%7D%22%5D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=postgres&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22pg_url%22%2C%22description%22%3A%22PostgreSQL%20URL%20(e.g.%20postgresql%3A%2F%2Fuser%3Apass%40localhost%3A5432%2Fmydb)%22%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-postgres%22%2C%22%24%7Binput%3Apg_url%7D%22%5D%7D&quality=insiders)
-
-[](https://insiders.vscode.dev/redirect/mcp/install?name=postgres&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22pg_url%22%2C%22description%22%3A%22PostgreSQL%20URL%20(e.g.%20postgresql%3A%2F%2Fuser%3Apass%40host.docker.internal%3A5432%2Fmydb)%22%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Fpostgres%22%2C%22%24%7Binput%3Apg_url%7D%22%5D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=postgres&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22pg_url%22%2C%22description%22%3A%22PostgreSQL%20URL%20(e.g.%20postgresql%3A%2F%2Fuser%3Apass%40host.docker.internal%3A5432%2Fmydb)%22%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Fpostgres%22%2C%22%24%7Binput%3Apg_url%7D%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)`.
-
-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.
-
-> Note that the `mcp` key is not needed in the `.vscode/mcp.json` file.
-
-For NPX installation:
-
-```json
-{
- "mcp": {
- "inputs": [
- {
- "type": "promptString",
- "id": "pg_url",
- "description": "PostgreSQL URL (e.g. postgresql://user:pass@localhost:5432/mydb)"
- }
- ],
- "servers": {
- "postgres": {
- "command": "npx",
- "args": [
- "-y",
- "@modelcontextprotocol/server-postgres",
- "${input:pg_url}"
- ]
- }
- }
- }
-}
-```
-
-For Docker installation:
-
-**Note**: When using Docker and connecting to a PostgreSQL server on your host machine, use `host.docker.internal` instead of `localhost` in the connection URL.
-
-```json
-{
- "mcp": {
- "inputs": [
- {
- "type": "promptString",
- "id": "pg_url",
- "description": "PostgreSQL URL (e.g. postgresql://user:pass@host.docker.internal:5432/mydb)"
- }
- ],
- "servers": {
- "postgres": {
- "command": "docker",
- "args": [
- "run",
- "-i",
- "--rm",
- "mcp/postgres",
- "${input:pg_url}"
- ]
- }
- }
- }
-}
-```
-
### Usage with Claude Desktop
To use this server with the Claude Desktop app, add the following configuration to the "mcpServers" section of your `claude_desktop_config.json`:
@@ -136,6 +66,76 @@ To use this server with the Claude Desktop app, add the following configuration
Replace `/mydb` with your database name.
+### Usage with VS Code
+
+For quick installation, use one of the one-click install buttons below...
+
+[](https://insiders.vscode.dev/redirect/mcp/install?name=postgres&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22pg_url%22%2C%22description%22%3A%22PostgreSQL%20URL%20(e.g.%20postgresql%3A%2F%2Fuser%3Apass%40localhost%3A5432%2Fmydb)%22%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-postgres%22%2C%22%24%7Binput%3Apg_url%7D%22%5D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=postgres&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22pg_url%22%2C%22description%22%3A%22PostgreSQL%20URL%20(e.g.%20postgresql%3A%2F%2Fuser%3Apass%40localhost%3A5432%2Fmydb)%22%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-postgres%22%2C%22%24%7Binput%3Apg_url%7D%22%5D%7D&quality=insiders)
+
+[](https://insiders.vscode.dev/redirect/mcp/install?name=postgres&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22pg_url%22%2C%22description%22%3A%22PostgreSQL%20URL%20(e.g.%20postgresql%3A%2F%2Fuser%3Apass%40host.docker.internal%3A5432%2Fmydb)%22%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Fpostgres%22%2C%22%24%7Binput%3Apg_url%7D%22%5D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=postgres&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22pg_url%22%2C%22description%22%3A%22PostgreSQL%20URL%20(e.g.%20postgresql%3A%2F%2Fuser%3Apass%40host.docker.internal%3A5432%2Fmydb)%22%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Fpostgres%22%2C%22%24%7Binput%3Apg_url%7D%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)`.
+
+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.
+
+> Note that the `mcp` key is not needed in the `.vscode/mcp.json` file.
+
+### Docker
+
+**Note**: When using Docker and connecting to a PostgreSQL server on your host machine, use `host.docker.internal` instead of `localhost` in the connection URL.
+
+```json
+{
+ "mcp": {
+ "inputs": [
+ {
+ "type": "promptString",
+ "id": "pg_url",
+ "description": "PostgreSQL URL (e.g. postgresql://user:pass@host.docker.internal:5432/mydb)"
+ }
+ ],
+ "servers": {
+ "postgres": {
+ "command": "docker",
+ "args": [
+ "run",
+ "-i",
+ "--rm",
+ "mcp/postgres",
+ "${input:pg_url}"
+ ]
+ }
+ }
+ }
+}
+```
+
+### NPX
+
+```json
+{
+ "mcp": {
+ "inputs": [
+ {
+ "type": "promptString",
+ "id": "pg_url",
+ "description": "PostgreSQL URL (e.g. postgresql://user:pass@localhost:5432/mydb)"
+ }
+ ],
+ "servers": {
+ "postgres": {
+ "command": "npx",
+ "args": [
+ "-y",
+ "@modelcontextprotocol/server-postgres",
+ "${input:pg_url}"
+ ]
+ }
+ }
+ }
+}
+```
+
## Building
Docker:
diff --git a/src/puppeteer/README.md b/src/puppeteer/README.md
index d5fd1eaf..f39b8a7b 100644
--- a/src/puppeteer/README.md
+++ b/src/puppeteer/README.md
@@ -7,6 +7,7 @@ A Model Context Protocol server that provides browser automation capabilities us
### Tools
- **puppeteer_navigate**
+
- Navigate to any URL in the browser
- Inputs:
- `url` (string, required): URL to navigate to
@@ -14,6 +15,7 @@ A Model Context Protocol server that provides browser automation capabilities us
- `allowDangerous` (boolean, optional): Allow dangerous LaunchOptions that reduce security. When false, dangerous args like `--no-sandbox`, `--disable-web-security` will throw errors. Default false.
- **puppeteer_screenshot**
+
- Capture screenshots of the entire page or specific elements
- Inputs:
- `name` (string, required): Name for the screenshot
@@ -22,20 +24,24 @@ A Model Context Protocol server that provides browser automation capabilities us
- `height` (number, optional, default: 600): Screenshot height
- **puppeteer_click**
+
- Click elements on the page
- Input: `selector` (string): CSS selector for element to click
- **puppeteer_hover**
+
- Hover elements on the page
- Input: `selector` (string): CSS selector for element to hover
- **puppeteer_fill**
+
- Fill out input fields
- Inputs:
- `selector` (string): CSS selector for input field
- `value` (string): Value to fill
- **puppeteer_select**
+
- Select an element with SELECT tag
- Inputs:
- `selector` (string): CSS selector for element to select
@@ -50,6 +56,7 @@ A Model Context Protocol server that provides browser automation capabilities us
The server provides access to two types of resources:
1. **Console Logs** (`console://logs`)
+
- Browser console output in text format
- Includes all console messages from the browser
@@ -68,6 +75,46 @@ The server provides access to two types of resources:
## Configuration to use Puppeteer Server
+### Usage with Claude Desktop
+
+Here's the Claude Desktop configuration to use the Puppeter server:
+
+### Docker
+
+**NOTE** The docker implementation will use headless chromium, where as the NPX version will open a browser window.
+
+```json
+{
+ "mcpServers": {
+ "puppeteer": {
+ "command": "docker",
+ "args": [
+ "run",
+ "-i",
+ "--rm",
+ "--init",
+ "-e",
+ "DOCKER_CONTAINER=true",
+ "mcp/puppeteer"
+ ]
+ }
+ }
+}
+```
+
+### NPX
+
+```json
+{
+ "mcpServers": {
+ "puppeteer": {
+ "command": "npx",
+ "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
+ }
+ }
+}
+```
+
### Usage with VS Code
For quick installation, use one of the one-click install buttons below...
@@ -120,58 +167,26 @@ For Docker installation (uses headless chromium):
}
```
-### Usage with Claude Desktop
-
-Here's the Claude Desktop configuration to use the Puppeter server:
-
-### Docker
-
-**NOTE** The docker implementation will use headless chromium, where as the NPX version will open a browser window.
-
-```json
-{
- "mcpServers": {
- "puppeteer": {
- "command": "docker",
- "args": ["run", "-i", "--rm", "--init", "-e", "DOCKER_CONTAINER=true", "mcp/puppeteer"]
- }
- }
-}
-```
-
-### NPX
-
-```json
-{
- "mcpServers": {
- "puppeteer": {
- "command": "npx",
- "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
- }
- }
-}
-```
-
### Launch Options
You can customize Puppeteer's browser behavior in two ways:
1. **Environment Variable**: Set `PUPPETEER_LAUNCH_OPTIONS` with a JSON-encoded string in the MCP configuration's `env` parameter:
- ```json
- {
- "mcpServers": {
- "mcp-puppeteer": {
- "command": "npx",
- "args": ["-y", "@modelcontextprotocol/server-puppeteer"],
- "env": {
- "PUPPETEER_LAUNCH_OPTIONS": "{ \"headless\": false, \"executablePath\": \"C:/Program Files/Google/Chrome/Application/chrome.exe\", \"args\": [] }",
- "ALLOW_DANGEROUS": "true"
- }
- }
- }
- }
- ```
+ ```json
+ {
+ "mcpServers": {
+ "mcp-puppeteer": {
+ "command": "npx",
+ "args": ["-y", "@modelcontextprotocol/server-puppeteer"],
+ "env": {
+ "PUPPETEER_LAUNCH_OPTIONS": "{ \"headless\": false, \"executablePath\": \"C:/Program Files/Google/Chrome/Application/chrome.exe\", \"args\": [] }",
+ "ALLOW_DANGEROUS": "true"
+ }
+ }
+ }
+ }
+ ```
2. **Tool Call Arguments**: Pass `launchOptions` and `allowDangerous` parameters to the `puppeteer_navigate` tool:
@@ -180,7 +195,7 @@ You can customize Puppeteer's browser behavior in two ways:
"url": "https://example.com",
"launchOptions": {
"headless": false,
- "defaultViewport": {"width": 1280, "height": 720}
+ "defaultViewport": { "width": 1280, "height": 720 }
}
}
```
@@ -195,4 +210,4 @@ docker build -t mcp/puppeteer -f src/puppeteer/Dockerfile .
## License
-This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
\ No newline at end of file
+This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
diff --git a/src/redis/README.md b/src/redis/README.md
index 4c44673c..96df4aea 100644
--- a/src/redis/README.md
+++ b/src/redis/README.md
@@ -50,6 +50,48 @@ A Model Context Protocol server that provides access to Redis databases. This se
- List Redis keys matching a pattern
- Input: `pattern` (string, optional): Pattern to match keys (default: *)
+## Usage with Claude Desktop
+
+To use this server with the Claude Desktop app, add the following configuration to the "mcpServers" section of your `claude_desktop_config.json`:
+
+### Docker
+
+* when running docker on macos, use host.docker.internal if the server is running on the host network (eg localhost)
+* Redis URL can be specified as an argument, defaults to "redis://localhost:6379"
+
+```json
+{
+ "mcpServers": {
+ "redis": {
+ "command": "docker",
+ "args": [
+ "run",
+ "-i",
+ "--rm",
+ "mcp/redis",
+ "redis://host.docker.internal:6379"]
+ }
+ }
+}
+```
+
+### NPX
+
+```json
+{
+ "mcpServers": {
+ "redis": {
+ "command": "npx",
+ "args": [
+ "-y",
+ "@modelcontextprotocol/server-redis",
+ "redis://localhost:6379"
+ ]
+ }
+ }
+}
+```
+
## Usage with VS Code
For quick installation, use one of the one-click install buttons below...
@@ -112,56 +154,6 @@ For Docker installation:
}
```
-## Usage with Claude Desktop
-
-To use this server with the Claude Desktop app, add the following configuration to the "mcpServers" section of your `claude_desktop_config.json`:
-
-### Docker
-
-* when running docker on macos, use host.docker.internal if the server is running on the host network (eg localhost)
-* Redis URL can be specified as an argument, defaults to "redis://localhost:6379"
-
-```json
-{
- "mcpServers": {
- "redis": {
- "command": "docker",
- "args": [
- "run",
- "-i",
- "--rm",
- "mcp/redis",
- "redis://host.docker.internal:6379"]
- }
- }
-}
-```
-
-### NPX
-
-```json
-{
- "mcpServers": {
- "redis": {
- "command": "npx",
- "args": [
- "-y",
- "@modelcontextprotocol/server-redis",
- "redis://localhost:6379"
- ]
- }
- }
-}
-```
-
-## Building
-
-Docker:
-
-```sh
-docker build -t mcp/redis -f src/redis/Dockerfile .
-```
-
## License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
diff --git a/src/sentry/README.md b/src/sentry/README.md
index f57e6677..216d9b5b 100644
--- a/src/sentry/README.md
+++ b/src/sentry/README.md
@@ -111,6 +111,9 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
> Note that the `mcp` key is needed when using the `mcp.json` file.
+
+Using uvx
+
```json
{
"mcp": {
@@ -134,8 +137,10 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
}
}
```
+
-For Docker installation:
+
+Using docker
```json
{
@@ -160,6 +165,7 @@ For Docker installation:
}
}
```
+
### Usage with [Zed](https://github.com/zed-industries/zed)
diff --git a/src/sequentialthinking/README.md b/src/sequentialthinking/README.md
index 8a38775c..d7a03dca 100644
--- a/src/sequentialthinking/README.md
+++ b/src/sequentialthinking/README.md
@@ -39,6 +39,44 @@ The Sequential Thinking tool is designed for:
## Configuration
+### Usage with Claude Desktop
+
+Add this to your `claude_desktop_config.json`:
+
+#### npx
+
+```json
+{
+ "mcpServers": {
+ "sequential-thinking": {
+ "command": "npx",
+ "args": [
+ "-y",
+ "@modelcontextprotocol/server-sequential-thinking"
+ ]
+ }
+ }
+}
+```
+
+#### docker
+
+```json
+{
+ "mcpServers": {
+ "sequentialthinking": {
+ "command": "docker",
+ "args": [
+ "run",
+ "--rm",
+ "-i",
+ "mcp/sequentialthinking"
+ ]
+ }
+ }
+}
+```
+
### Usage with VS Code
For quick installation, click one of the installation buttons below...
@@ -91,44 +129,6 @@ For Docker installation:
}
```
-### Usage with Claude Desktop
-
-Add this to your `claude_desktop_config.json`:
-
-#### npx
-
-```json
-{
- "mcpServers": {
- "sequential-thinking": {
- "command": "npx",
- "args": [
- "-y",
- "@modelcontextprotocol/server-sequential-thinking"
- ]
- }
- }
-}
-```
-
-#### docker
-
-```json
-{
- "mcpServers": {
- "sequentialthinking": {
- "command": "docker",
- "args": [
- "run",
- "--rm",
- "-i",
- "mcp/sequentialthinking"
- ]
- }
- }
-}
-```
-
## Building
Docker:
diff --git a/src/slack/README.md b/src/slack/README.md
index 9800caef..ff5f84ca 100644
--- a/src/slack/README.md
+++ b/src/slack/README.md
@@ -85,89 +85,11 @@ MCP Server for the Slack API, enabling Claude to interact with Slack workspaces.
5. Get your Team ID (starts with a `T`) by following [this guidance](https://slack.com/help/articles/221769328-Locate-your-Slack-URL-or-ID#find-your-workspace-or-org-id)
-### Usage with VS Code
-
-For quick installation, click one of the installation buttons below...
-
-[](https://insiders.vscode.dev/redirect/mcp/install?name=slack&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22slack_bot_token%22%2C%22description%22%3A%22Slack%20Bot%20Token%20(starts%20with%20xoxb-)%22%2C%22password%22%3Atrue%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22slack_team_id%22%2C%22description%22%3A%22Slack%20Team%20ID%20(starts%20with%20T)%22%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-slack%22%5D%2C%22env%22%3A%7B%22SLACK_BOT_TOKEN%22%3A%22%24%7Binput%3Aslack_bot_token%7D%22%2C%22SLACK_TEAM_ID%22%3A%22%24%7Binput%3Aslack_team_id%7D%22%7D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=slack&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22slack_bot_token%22%2C%22description%22%3A%22Slack%20Bot%20Token%20(starts%20with%20xoxb-)%22%2C%22password%22%3Atrue%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22slack_team_id%22%2C%22description%22%3A%22Slack%20Team%20ID%20(starts%20with%20T)%22%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-slack%22%5D%2C%22env%22%3A%7B%22SLACK_BOT_TOKEN%22%3A%22%24%7Binput%3Aslack_bot_token%7D%22%2C%22SLACK_TEAM_ID%22%3A%22%24%7Binput%3Aslack_team_id%7D%22%7D%7D&quality=insiders)
-
-[](https://insiders.vscode.dev/redirect/mcp/install?name=slack&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22slack_bot_token%22%2C%22description%22%3A%22Slack%20Bot%20Token%20(starts%20with%20xoxb-)%22%2C%22password%22%3Atrue%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22slack_team_id%22%2C%22description%22%3A%22Slack%20Team%20ID%20(starts%20with%20T)%22%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Fslack%22%5D%2C%22env%22%3A%7B%22SLACK_BOT_TOKEN%22%3A%22%24%7Binput%3Aslack_bot_token%7D%22%2C%22SLACK_TEAM_ID%22%3A%22%24%7Binput%3Aslack_team_id%7D%22%7D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=slack&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22slack_bot_token%22%2C%22description%22%3A%22Slack%20Bot%20Token%20(starts%20with%20xoxb-)%22%2C%22password%22%3Atrue%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22slack_team_id%22%2C%22description%22%3A%22Slack%20Team%20ID%20(starts%20with%20T)%22%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Fslack%22%5D%2C%22env%22%3A%7B%22SLACK_BOT_TOKEN%22%3A%22%24%7Binput%3Aslack_bot_token%7D%22%2C%22SLACK_TEAM_ID%22%3A%22%24%7Binput%3Aslack_team_id%7D%22%7D%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)`.
-
-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.
-
-> Note that the `mcp` key is not needed in the `.vscode/mcp.json` file.
-
-For NPX installation:
-
-```json
-{
- "mcp": {
- "inputs": [
- {
- "type": "promptString",
- "id": "slack_bot_token",
- "description": "Slack Bot Token (starts with xoxb-)",
- "password": true
- },
- {
- "type": "promptString",
- "id": "slack_team_id",
- "description": "Slack Team ID (starts with T)"
- }
- ],
- "servers": {
- "slack": {
- "command": "npx",
- "args": ["-y", "@modelcontextprotocol/server-slack"],
- "env": {
- "SLACK_BOT_TOKEN": "${input:slack_bot_token}",
- "SLACK_TEAM_ID": "${input:slack_team_id}"
- }
- }
- }
- }
-}
-```
-
-For Docker installation:
-
-```json
-{
- "mcp": {
- "inputs": [
- {
- "type": "promptString",
- "id": "slack_bot_token",
- "description": "Slack Bot Token (starts with xoxb-)",
- "password": true
- },
- {
- "type": "promptString",
- "id": "slack_team_id",
- "description": "Slack Team ID (starts with T)"
- }
- ],
- "servers": {
- "slack": {
- "command": "docker",
- "args": ["run", "-i", "--rm", "mcp/slack"],
- "env": {
- "SLACK_BOT_TOKEN": "${input:slack_bot_token}",
- "SLACK_TEAM_ID": "${input:slack_team_id}"
- }
- }
- }
- }
-}
-```
-
### Usage with Claude Desktop
Add the following to your `claude_desktop_config.json`:
-#### npx
+#### NPX
```json
{
@@ -213,6 +135,84 @@ Add the following to your `claude_desktop_config.json`:
}
```
+### Usage with VS Code
+
+For quick installation, click one of the installation buttons below...
+
+[](https://insiders.vscode.dev/redirect/mcp/install?name=slack&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22slack_bot_token%22%2C%22description%22%3A%22Slack%20Bot%20Token%20(starts%20with%20xoxb-)%22%2C%22password%22%3Atrue%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22slack_team_id%22%2C%22description%22%3A%22Slack%20Team%20ID%20(starts%20with%20T)%22%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-slack%22%5D%2C%22env%22%3A%7B%22SLACK_BOT_TOKEN%22%3A%22%24%7Binput%3Aslack_bot_token%7D%22%2C%22SLACK_TEAM_ID%22%3A%22%24%7Binput%3Aslack_team_id%7D%22%7D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=slack&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22slack_bot_token%22%2C%22description%22%3A%22Slack%20Bot%20Token%20(starts%20with%20xoxb-)%22%2C%22password%22%3Atrue%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22slack_team_id%22%2C%22description%22%3A%22Slack%20Team%20ID%20(starts%20with%20T)%22%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-slack%22%5D%2C%22env%22%3A%7B%22SLACK_BOT_TOKEN%22%3A%22%24%7Binput%3Aslack_bot_token%7D%22%2C%22SLACK_TEAM_ID%22%3A%22%24%7Binput%3Aslack_team_id%7D%22%7D%7D&quality=insiders)
+
+[](https://insiders.vscode.dev/redirect/mcp/install?name=slack&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22slack_bot_token%22%2C%22description%22%3A%22Slack%20Bot%20Token%20(starts%20with%20xoxb-)%22%2C%22password%22%3Atrue%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22slack_team_id%22%2C%22description%22%3A%22Slack%20Team%20ID%20(starts%20with%20T)%22%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Fslack%22%5D%2C%22env%22%3A%7B%22SLACK_BOT_TOKEN%22%3A%22%24%7Binput%3Aslack_bot_token%7D%22%2C%22SLACK_TEAM_ID%22%3A%22%24%7Binput%3Aslack_team_id%7D%22%7D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=slack&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22slack_bot_token%22%2C%22description%22%3A%22Slack%20Bot%20Token%20(starts%20with%20xoxb-)%22%2C%22password%22%3Atrue%7D%2C%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22slack_team_id%22%2C%22description%22%3A%22Slack%20Team%20ID%20(starts%20with%20T)%22%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Fslack%22%5D%2C%22env%22%3A%7B%22SLACK_BOT_TOKEN%22%3A%22%24%7Binput%3Aslack_bot_token%7D%22%2C%22SLACK_TEAM_ID%22%3A%22%24%7Binput%3Aslack_team_id%7D%22%7D%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)`.
+
+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.
+
+> Note that the `mcp` key is not needed in the `.vscode/mcp.json` file.
+
+#### NPX
+
+```json
+{
+ "mcp": {
+ "inputs": [
+ {
+ "type": "promptString",
+ "id": "slack_bot_token",
+ "description": "Slack Bot Token (starts with xoxb-)",
+ "password": true
+ },
+ {
+ "type": "promptString",
+ "id": "slack_team_id",
+ "description": "Slack Team ID (starts with T)"
+ }
+ ],
+ "servers": {
+ "slack": {
+ "command": "npx",
+ "args": ["-y", "@modelcontextprotocol/server-slack"],
+ "env": {
+ "SLACK_BOT_TOKEN": "${input:slack_bot_token}",
+ "SLACK_TEAM_ID": "${input:slack_team_id}"
+ }
+ }
+ }
+ }
+}
+```
+
+#### Docker
+
+```json
+{
+ "mcp": {
+ "inputs": [
+ {
+ "type": "promptString",
+ "id": "slack_bot_token",
+ "description": "Slack Bot Token (starts with xoxb-)",
+ "password": true
+ },
+ {
+ "type": "promptString",
+ "id": "slack_team_id",
+ "description": "Slack Team ID (starts with T)"
+ }
+ ],
+ "servers": {
+ "slack": {
+ "command": "docker",
+ "args": ["run", "-i", "--rm", "mcp/slack"],
+ "env": {
+ "SLACK_BOT_TOKEN": "${input:slack_bot_token}",
+ "SLACK_TEAM_ID": "${input:slack_team_id}"
+ }
+ }
+ }
+ }
+}
+```
+
### Troubleshooting
If you encounter permission errors, verify that:
diff --git a/src/sqlite/README.md b/src/sqlite/README.md
index 14485e0c..08d6bfda 100644
--- a/src/sqlite/README.md
+++ b/src/sqlite/README.md
@@ -3,79 +3,6 @@
## Overview
A Model Context Protocol (MCP) server implementation that provides database interaction and business intelligence capabilities through SQLite. This server enables running SQL queries, analyzing business data, and automatically generating business insight memos.
-### Installation
-
-For quick installation, click the installation buttons below:
-
-[](https://insiders.vscode.dev/redirect/mcp/install?name=sqlite&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22db_path%22%2C%22description%22%3A%22SQLite%20Database%20Path%22%2C%22default%22%3A%22%24%7BworkspaceFolder%7D%2Fdb.sqlite%22%7D%5D&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-sqlite%22%2C%22--db-path%22%2C%22%24%7Binput%3Adb_path%7D%22%5D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=sqlite&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22db_path%22%2C%22description%22%3A%22SQLite%20Database%20Path%22%2C%22default%22%3A%22%24%7BworkspaceFolder%7D%2Fdb.sqlite%22%7D%5D&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-sqlite%22%2C%22--db-path%22%2C%22%24%7Binput%3Adb_path%7D%22%5D%7D&quality=insiders)
-
-[](https://insiders.vscode.dev/redirect/mcp/install?name=sqlite&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22db_path%22%2C%22description%22%3A%22SQLite%20Database%20Path%20(within%20container)%22%2C%22default%22%3A%22%2Fmcp%2Fdb.sqlite%22%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-v%22%2C%22mcp-sqlite%3A%2Fmcp%22%2C%22mcp%2Fsqlite%22%2C%22--db-path%22%2C%22%24%7Binput%3Adb_path%7D%22%5D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=sqlite&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22db_path%22%2C%22description%22%3A%22SQLite%20Database%20Path%20(within%20container)%22%2C%22default%22%3A%22%2Fmcp%2Fdb.sqlite%22%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-v%22%2C%22mcp-sqlite%3A%2Fmcp%22%2C%22mcp%2Fsqlite%22%2C%22--db-path%22%2C%22%24%7Binput%3Adb_path%7D%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)`.
-
-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.
-
-> Note that the `mcp` key is needed when using the `mcp.json` file.
-
-For UV installation:
-
-```json
-{
- "mcp": {
- "inputs": [
- {
- "type": "promptString",
- "id": "db_path",
- "description": "SQLite Database Path",
- "default": "${workspaceFolder}/db.sqlite"
- }
- ],
- "servers": {
- "sqlite": {
- "command": "uvx",
- "args": [
- "mcp-server-sqlite",
- "--db-path",
- "${input:db_path}"
- ]
- }
- }
- }
-}
-```
-
-For Docker installation:
-
-```json
-{
- "mcp": {
- "inputs": [
- {
- "type": "promptString",
- "id": "db_path",
- "description": "SQLite Database Path (within container)",
- "default": "/mcp/db.sqlite"
- }
- ],
- "servers": {
- "sqlite": {
- "command": "docker",
- "args": [
- "run",
- "-i",
- "--rm",
- "-v",
- "mcp-sqlite:/mcp",
- "mcp/sqlite",
- "--db-path",
- "${input:db_path}"
- ]
- }
- }
- }
-}
-```
-
## Components
### Resources
@@ -176,6 +103,79 @@ The server offers six core tools:
}
```
+## Usage with VS Code
+
+For quick installation, click the installation buttons below:
+
+[](https://insiders.vscode.dev/redirect/mcp/install?name=sqlite&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22db_path%22%2C%22description%22%3A%22SQLite%20Database%20Path%22%2C%22default%22%3A%22%24%7BworkspaceFolder%7D%2Fdb.sqlite%22%7D%5D&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-sqlite%22%2C%22--db-path%22%2C%22%24%7Binput%3Adb_path%7D%22%5D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=sqlite&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22db_path%22%2C%22description%22%3A%22SQLite%20Database%20Path%22%2C%22default%22%3A%22%24%7BworkspaceFolder%7D%2Fdb.sqlite%22%7D%5D&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-sqlite%22%2C%22--db-path%22%2C%22%24%7Binput%3Adb_path%7D%22%5D%7D&quality=insiders)
+
+[](https://insiders.vscode.dev/redirect/mcp/install?name=sqlite&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22db_path%22%2C%22description%22%3A%22SQLite%20Database%20Path%20(within%20container)%22%2C%22default%22%3A%22%2Fmcp%2Fdb.sqlite%22%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-v%22%2C%22mcp-sqlite%3A%2Fmcp%22%2C%22mcp%2Fsqlite%22%2C%22--db-path%22%2C%22%24%7Binput%3Adb_path%7D%22%5D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=sqlite&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22db_path%22%2C%22description%22%3A%22SQLite%20Database%20Path%20(within%20container)%22%2C%22default%22%3A%22%2Fmcp%2Fdb.sqlite%22%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-v%22%2C%22mcp-sqlite%3A%2Fmcp%22%2C%22mcp%2Fsqlite%22%2C%22--db-path%22%2C%22%24%7Binput%3Adb_path%7D%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)`.
+
+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.
+
+> Note that the `mcp` key is needed when using the `mcp.json` file.
+
+### uv
+
+```json
+{
+ "mcp": {
+ "inputs": [
+ {
+ "type": "promptString",
+ "id": "db_path",
+ "description": "SQLite Database Path",
+ "default": "${workspaceFolder}/db.sqlite"
+ }
+ ],
+ "servers": {
+ "sqlite": {
+ "command": "uvx",
+ "args": [
+ "mcp-server-sqlite",
+ "--db-path",
+ "${input:db_path}"
+ ]
+ }
+ }
+ }
+}
+```
+
+### Docker
+
+```json
+{
+ "mcp": {
+ "inputs": [
+ {
+ "type": "promptString",
+ "id": "db_path",
+ "description": "SQLite Database Path (within container)",
+ "default": "/mcp/db.sqlite"
+ }
+ ],
+ "servers": {
+ "sqlite": {
+ "command": "docker",
+ "args": [
+ "run",
+ "-i",
+ "--rm",
+ "-v",
+ "mcp-sqlite:/mcp",
+ "mcp/sqlite",
+ "--db-path",
+ "${input:db_path}"
+ ]
+ }
+ }
+ }
+}
+```
+
## Building
Docker:
diff --git a/src/time/README.md b/src/time/README.md
index eed504bb..58011a60 100644
--- a/src/time/README.md
+++ b/src/time/README.md
@@ -110,6 +110,54 @@ Add to your Zed settings.json:
```
+### Configure for VS Code
+
+For quick installation, use one of the one-click install buttons below...
+
+[](https://insiders.vscode.dev/redirect/mcp/install?name=time&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-time%22%5D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=time&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-time%22%5D%7D&quality=insiders)
+
+[](https://insiders.vscode.dev/redirect/mcp/install?name=time&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Ftime%22%5D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=time&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Ftime%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)`.
+
+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.
+
+> Note that the `mcp` key is needed when using the `mcp.json` file.
+
+
+Using uvx
+
+```json
+{
+ "mcp": {
+ "servers": {
+ "time": {
+ "command": "uvx",
+ "args": ["mcp-server-time"]
+ }
+ }
+ }
+}
+```
+
+
+
+Using Docker
+
+```json
+{
+ "mcp": {
+ "servers": {
+ "time": {
+ "command": "docker",
+ "args": ["run", "-i", "--rm", "mcp/time"]
+ }
+ }
+ }
+}
+```
+
+
### Customization - System Timezone
By default, the server automatically detects your system's timezone. You can override this by adding the argument `--local-timezone` to the `args` list in the configuration.