Model Context Protocol Servers

https://github.com/modelcontextprotocol/servers
Admin
A collection of reference implementations and community-built servers for the Model Context...
Tokens:60,517
Snippets:553
Trust Score:7.8
License:Apache-2.0
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### Start Git server with uvx or pip

Source: https://github.com/modelcontextprotocol/servers/blob/main/README.md

Starts the Git server using uvx (recommended) or pip. For pip, install the package first then run the module.

```sh
# With uvx
uvx mcp-server-git

# With pip
pip install mcp-server-git
python -m mcp_server_git
```

--------------------------------

### Start Memory server with npx

Source: https://github.com/modelcontextprotocol/servers/blob/main/README.md

Starts the Memory server directly with npx. Requires Node.js and npx installed.

```sh
npx -y @modelcontextprotocol/server-memory
```

--------------------------------

### Run from source with Streamable HTTP Transport

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md

Commands to install dependencies and start the server with the streamable HTTP transport.

```shell
cd src/everything
npm install
npm run start:streamableHttp
```

--------------------------------

### Install the Everything server globally

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md

Installs the latest version of the @modelcontextprotocol/server-everything package globally.

```shell
npm install -g @modelcontextprotocol/server-everything@latest
```

--------------------------------

### Debug with MCP inspector (uvx)

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/fetch/README.md

Start the MCP inspector for uvx installations to debug the server.

```bash
npx @modelcontextprotocol/inspector uvx mcp-server-fetch
```

--------------------------------

### Run from source with HTTP+SSE Transport

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md

Commands to install dependencies and start the server with the deprecated HTTP+SSE transport.

```shell
cd src/everything
npm install
npm run start:sse
```

--------------------------------

### Install mcp-server-fetch with pip

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/fetch/README.md

Installs the mcp-server-fetch package via pip.

```bash
pip install mcp-server-fetch
```

--------------------------------

### Run the default (stdio) server

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md

Starts the server using the default stdio transport.

```shell
npx @modelcontextprotocol/server-everything
```

--------------------------------

### Run the SSE server

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md

Starts the server with the SSE transport.

```shell
npx @modelcontextprotocol/server-everything sse
```

--------------------------------

### Start filesystem MCP server with allowed directories

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/README.md

Starts the filesystem MCP server with the specified directories as the allowed roots. The server restricts all filesystem operations to these directories. If no directories are provided and the client does not support the roots protocol, the server will throw an error during initialization.

```bash
mcp-server-filesystem /path/to/dir1 /path/to/dir2
```

--------------------------------

### Run the streamable HTTP server

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md

Starts the server with the streamable HTTP transport.

```shell
npx @modelcontextprotocol/server-everything streamableHttp
```

--------------------------------

### Install Time MCP Server with pip

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/time/README.md

Install the server package using pip.

```bash
pip install mcp-server-time
```

--------------------------------

### Run Time MCP Server with uvx

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/time/README.md

Directly execute the server using uvx without requiring a manual installation.

```bash
uvx mcp-server-time
```

--------------------------------

### Run mcp-server-fetch as a module

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/fetch/README.md

Runs the fetch server as a Python module after installation.

```bash
python -m mcp_server_fetch
```

--------------------------------

### Run Time MCP Server as a script

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/time/README.md

Execute the installed server package as a Python module.

```bash
python -m mcp_server_time
```

--------------------------------

### Debug with MCP inspector (development)

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/fetch/README.md

Start the MCP inspector when the package is installed in a specific directory or during development.

```bash
cd path/to/servers/src/fetch
npx @modelcontextprotocol/inspector uv run mcp-server-fetch
```

--------------------------------

### Install mcp-server-git with pip

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/git/README.md

Installs the mcp-server-git package via pip. After installation, the server can be run as a script using 'python -m mcp_server_git'.

```bash
pip install mcp-server-git
```

--------------------------------

### Run the server with stdio explicitly

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md

Starts the server with the stdio transport specified explicitly.

```shell
npx @modelcontextprotocol/server-everything stdio
```

--------------------------------

### Configure Zencoder with uvx

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/time/README.md

Add this name and server configuration to the Zencoder Agent Tools 'Add Custom MCP' dialog, then hit the Install button.

```json
{
    "command": "uvx",
    "args": ["mcp-server-time"]
  }
```

--------------------------------

### Codex CLI npx installation command

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/sequentialthinking/README.md

Run this command to add the sequential-thinking server to Codex CLI using npx.

```bash
codex mcp add sequential-thinking npx -y @modelcontextprotocol/server-sequential-thinking
```

--------------------------------

### Configure Zed with pip installation

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/time/README.md

Add this JSON block to your Zed settings.json to configure the time server using a pip installation.

```json
"context_servers": {
  "mcp-server-time": {
    "command": "python",
    "args": ["-m", "mcp_server_time"]
  }
},
```

--------------------------------

### Configure Claude.app with pip installation

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/time/README.md

Add this JSON block to your Claude settings to configure the time server using a pip installation.

```json
{
  "mcpServers": {
    "time": {
      "command": "python",
      "args": ["-m", "mcp_server_time"]
    }
  }
}
```

--------------------------------

### Convert time response (JSON)

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/time/README.md

Example response from the convert_time tool, showing source and target time details and time difference.

```json
{
  "source": {
    "timezone": "America/New_York",
    "datetime": "2024-01-01T12:30:00-05:00",
    "is_dst": false
  },
  "target": {
    "timezone": "Asia/Tokyo",
    "datetime": "2024-01-01T12:30:00+09:00",
    "is_dst": false
  },
  "time_difference": "+13.0h",
}
```

--------------------------------

### Claude Desktop configuration with pip

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/git/README.md

Configuration for Claude Desktop using pip installation. Uses the python command to run the mcp_server_git module.

```json
"mcpServers": {
  "git": {
    "command": "python",
    "args": ["-m", "mcp_server_git", "--repository", "path/to/git/repo"]
  }
}
```

--------------------------------

### Claude.app configuration using pip installation

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/fetch/README.md

JSON configuration block for Claude.app to run the fetch server via pip-installed Python module. Add this to your Claude settings to use the server with the 'python' command.

```json
{
  "mcpServers": {
    "fetch": {
      "command": "python",
      "args": ["-m", "mcp_server_fetch"]
    }
  }
}
```

--------------------------------

### Get current time request (JSON)

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/time/README.md

Example request to the get_current_time tool with a timezone argument.

```json
{
  "name": "get_current_time",
  "arguments": {
    "timezone": "Europe/Warsaw"
  }
}
```

--------------------------------

### Set up and test Python servers with uv

Source: https://github.com/modelcontextprotocol/servers/blob/main/CLAUDE.md

Commands to set up and run tests, type checking, and linting for Python servers. Uses uv as the package manager and requires Python >= 3.10.

```bash
cd src/<server> && uv sync --frozen --all-extras --dev

# Run tests (if tests/ or test/ directory exists)
uv run pytest

# Type checking
uv run pyright

# Linting
uv run ruff check .
```

--------------------------------

### Get current time response (JSON)

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/time/README.md

Example response from the get_current_time tool, showing timezone, datetime, and is_dst fields.

```json
{
  "timezone": "Europe/Warsaw",
  "datetime": "2024-01-01T13:00:00+01:00",
  "is_dst": false
}
```

--------------------------------

### System prompt for chat personalization with memory

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/memory/README.md

Example system prompt for chat personalization using the memory server. Place this in the Custom Instructions field of a Claude.ai Project to guide memory creation and retrieval.

```text
Follow these steps for each interaction:

1. User Identification:
   - You should assume that you are interacting with default_user
   - If you have not identified default_user, proactively try to do so.

2. Memory Retrieval:
   - Always begin your chat by saying only "Remembering..." and retrieve all relevant information from your knowledge graph
   - Always refer to your knowledge graph as your "memory"

3. Memory
   - While conversing with the user, be attentive to any new information that falls into these categories:
     a) Basic Identity (age, gender, location, job title, education level, etc.)
     b) Behaviors (interests, habits, etc.)
     c) Preferences (communication style, preferred language, etc.)
     d) Goals (goals, targets, aspirations, etc.)
     e) Relationships (personal and professional relationships up to 3 degrees of separation)

4. Memory Update:
   - If any new information was gathered during the interaction, update your memory as follows:
     a) Create entities for recurring organizations, people, and significant events
     b) Connect them to the current entities using relations
     c) Store facts about them as observations
```

--------------------------------

### Claude Desktop Configuration (UVX)

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/git/README.md

Add this configuration to claude_desktop_config.json to run the Git server using uv from the source directory.

```json
{
"mcpServers": {
  "git": {
    "command": "uv",
    "args": [
      "--directory",
      "/<path to mcp-servers>/mcp-servers/src/git",
      "run",
      "mcp-server-git"
    ]
    }
  }
}
```

--------------------------------

### Windows configuration (uvx)

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/fetch/README.md

Configure the fetch MCP server with uvx and set PYTHONIOENCODING to utf-8 to avoid timeout issues on Windows.

```json
{
  "mcpServers": {
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"],
      "env": {
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}
```

--------------------------------

### Claude Desktop configuration with uvx

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/git/README.md

Configuration for Claude Desktop using uvx. Add this to claude_desktop_config.json. The --repository argument specifies the path to the git repository.

```json
"mcpServers": {
  "git": {
    "command": "uvx",
    "args": ["mcp-server-git", "--repository", "path/to/git/repo"]
  }
}
```

--------------------------------

### Windows configuration (pip)

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/fetch/README.md

Configure the fetch MCP server with pip and set PYTHONIOENCODING to utf-8 to avoid timeout issues on Windows.

```json
{
  "mcpServers": {
    "fetch": {
      "command": "python",
      "args": ["-m", "mcp_server_fetch"],
      "env": {
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}
```

--------------------------------

### Run mcp-server-git as a Python module

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/git/README.md

Runs the mcp-server-git server as a Python module after pip installation.

```bash
python -m mcp_server_git
```

--------------------------------

### Build Docker image for sequentialthinking server

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/sequentialthinking/README.md

Builds the sequentialthinking MCP server Docker image with the tag mcp/sequentialthinking using the Dockerfile in src/sequentialthinking.

```bash
docker build -t mcp/sequentialthinking -f src/sequentialthinking/Dockerfile .
```

--------------------------------

### VS Code configuration with uvx

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/git/README.md

Manual configuration for VS Code using uvx. Add to user-level mcp.json or .vscode/mcp.json. This is the recommended method for user configuration.

```json
{
  "servers": {
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git"]
    }
  }
}
```

--------------------------------

### toggle-subscriber-updates

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/everything/docs/features.md

Starts or stops simulated resource update notifications for URIs the invoking session has subscribed to.

```APIDOC
## toggle-subscriber-updates

### Description
Starts or stops simulated resource update notifications for URIs the invoking session has subscribed to.

### Parameters
None.

### Response
Returns a text content block indicating whether updates have started or stopped.
```

--------------------------------

### Time MCP Server Tools

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/time/README.md

Tools for getting current time and converting time between timezones.

```APIDOC
## get_current_time

### Description
Get current time in a specific timezone or system timezone.

### Parameters
- `timezone` (string) - Required - IANA timezone name (e.g., 'America/New_York', 'Europe/London')

```

```APIDOC
## convert_time

### Description
Convert time between timezones.

### Parameters
- `source_timezone` (string) - Required - Source IANA timezone name
- `time` (string) - Required - Time in 24-hour format (HH:MM)
- `target_timezone` (string) - Required - Target IANA timezone name

```

--------------------------------

### Claude Desktop configuration for Everything MCP Server on Windows (cmd /c)

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md

Windows-specific configuration for claude_desktop_config.json. Uses 'cmd' with '/c' to launch npx, ensuring proper execution on Windows.

```json
{
  "mcpServers": {
    "everything": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@modelcontextprotocol/server-everything"
      ]
    }
  }
}
```

--------------------------------

### Observations JSON example

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/memory/README.md

Shows the structure for adding observations to an entity, with atomic facts stored as strings.

```json
{
  "entityName": "John_Smith",
  "observations": [
    "Speaks fluent Spanish",
    "Graduated in 2019",
    "Prefers morning meetings"
  ]
}
```

--------------------------------

### Build Docker image for filesystem MCP server

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/README.md

Use this command to build the Docker image for the filesystem MCP server. The image is tagged as mcp/filesystem and uses the Dockerfile located at src/filesystem/Dockerfile.

```bash
docker build -t mcp/filesystem -f src/filesystem/Dockerfile .
```

--------------------------------

### Claude Desktop configuration for Everything MCP Server (npx)

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md

Add this JSON to claude_desktop_config.json to run the Everything server via npx using stdio transport. The server is launched with the command 'npx' and arguments '-y' and '@modelcontextprotocol/server-everything'.

```json
{
  "mcpServers": {
    "everything": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-everything"
      ]
    }
  }
}
```

--------------------------------

### Relation JSON example

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/memory/README.md

Shows the structure of a directed relation between two entities, stored in active voice.

```json
{
  "from": "John_Smith",
  "to": "Anthropic",
  "relationType": "works_at"
}
```

--------------------------------

### VS Code Docker configuration

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/sequentialthinking/README.md

Add this configuration to your VS Code user mcp.json or .vscode/mcp.json for Docker installation.

```json
{
  "servers": {
    "sequential-thinking": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/sequentialthinking"
      ]
    }
  }
}
```

--------------------------------

### Configure Zed with uvx

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/time/README.md

Add this JSON block to your Zed settings.json to configure the time server using uvx.

```json
"context_servers": [
  "mcp-server-time": {
    "command": "uvx",
    "args": ["mcp-server-time"]
  }
],
```

--------------------------------

### Claude Desktop Configuration (Docker)

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/git/README.md

Add this configuration to claude_desktop_config.json to run the Git server via Docker, mounting allowed directories.

```json
{
  "mcpServers": {
    "git": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--mount", "type=bind,src=/Users/username/Desktop,dst=/projects/Desktop",
        "--mount", "type=bind,src=/path/to/other/allowed/dir,dst=/projects/other/allowed/dir,ro",
        "--mount", "type=bind,src=/path/to/file.txt,dst=/projects/path/to/file.txt",
        "mcp/git"
      ]
    }
  }
}
```

--------------------------------

### VS Code NPX configuration

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/sequentialthinking/README.md

Add this configuration to your VS Code user mcp.json or .vscode/mcp.json for NPX installation.

```json
{
  "servers": {
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    }
  }
}
```

--------------------------------

### Build and test TypeScript servers

Source: https://github.com/modelcontextprotocol/servers/blob/main/CLAUDE.md

Commands to build and test TypeScript servers. For a single server, run from its directory; for all servers, run from the root. Requires Node 22 and npm.

```bash
# Single server
cd src/<server> && npm ci && npm run build && npm test

# All TS servers from root
npm install && npm run build
```

--------------------------------

### Claude Desktop NPX configuration for filesystem server

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/README.md

Configure the filesystem MCP server in Claude Desktop using NPX. Specify allowed directories as arguments.

```json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}
```

--------------------------------

### Debug with MCP inspector (uv run)

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/time/README.md

Command to run the MCP inspector when the package is installed in a specific directory or during development.

```bash
cd path/to/servers/src/time
npx @modelcontextprotocol/inspector uv run mcp-server-time
```

--------------------------------

### Convert time request (JSON)

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/time/README.md

Example request to the convert_time tool with source timezone, time, and target timezone arguments.

```json
{
  "name": "convert_time",
  "arguments": {
    "source_timezone": "America/New_York",
    "time": "16:30",
    "target_timezone": "Asia/Tokyo"
  }
}
```

--------------------------------

### Docker Build Command

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/git/README.md

Build the Docker image for the Git server from the src/git directory.

```bash
cd src/git
docker build -t mcp/git .
```

--------------------------------

### Entity JSON example

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/memory/README.md

Shows the structure of an entity in the knowledge graph, with a unique name, entity type, and a list of observations.

```json
{
  "name": "John_Smith",
  "entityType": "person",
  "observations": ["Speaks fluent Spanish"]
}
```

--------------------------------

### Claude Desktop configs for multiple servers

Source: https://github.com/modelcontextprotocol/servers/blob/main/README.md

Additional Claude Desktop configurations for filesystem, git, github, and postgres servers. On Windows, wrap each npx-based entry with cmd /c.

```json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
    },
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git", "--repository", "path/to/git/repo"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    }
  }
}
```

--------------------------------

### Zed configuration with pip

Source: https://github.com/modelcontextprotocol/servers/blob/main/src/git/README.md

Configuration for Zed editor using pip installation. Uses the python command to run the mcp_server_git module.

```json
"context_servers": {
  "mcp-server-git": {
    "command": {
      "path": "python",
      "args": ["-m", "mcp_server_git"]
    }
  }
},
```
Tokens:
Raw