servers README

The project's README from github.com/modelcontextprotocol/servers. As one markdown file: README.md.

Model Context Protocol servers

This repository is a collection of reference implementations for the Model Context Protocol (MCP), as well as references to community-built servers and additional resources.

[!IMPORTANT] If you are looking for a list of MCP servers, you can browse published servers on the MCP Registry. The repository served by this README is dedicated to housing just the small number of reference servers maintained by the MCP steering group.

[!WARNING] The servers in this repository are intended as reference implementations to demonstrate MCP features and SDK usage. They are meant to serve as educational examples for developers building their own MCP servers, not as production-ready solutions. Developers should evaluate their own security requirements and implement appropriate safeguards based on their specific threat model and use case.

The servers in this repository showcase the versatility and extensibility of MCP, demonstrating how it can be used to give Large Language Models (LLMs) secure, controlled access to tools and data sources. Typically, each MCP server is implemented with an MCP SDK:

🌟 Reference Servers

These servers aim to demonstrate MCP features and the official SDKs.

Archived

The following reference servers are now archived and can be found at servers-archived.

🚀 Getting Started

Using MCP Servers in this Repository

TypeScript-based servers in this repository can be used directly with npx.

For example, this will start the Memory server:

npx -y @modelcontextprotocol/server-memory

Python-based servers in this repository can be used directly with uvx or pip. uvx is recommended for ease of use and setup.

For example, this will start the Git server:

# With uvx
uvx mcp-server-git

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

Follow these instructions to install uv / uvx and these to install pip.

Using an MCP Client

However, running a server on its own isn't very useful, and should instead be configured into an MCP client. For example, here's the Claude Desktop configuration to use the above server:

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

On Windows, wrap npx with cmd /c:

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

Additional examples of using the Claude Desktop as an MCP client might look like:

{
  "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"]
    }
  }
}

On Windows, apply the same wrapper to each npx-based entry above by changing "command" to "cmd" and prepending "/c", "npx" to the existing args. Leave uvx entries unchanged.

🛠️ Creating Your Own Server

Interested in creating your own MCP server? Visit the official documentation at modelcontextprotocol.io for comprehensive guides, best practices, and technical details on implementing MCP servers.

📚 Learn More

See ADDITIONAL.md for a curated list of frameworks and resources that simplify building MCP servers and clients.

🤝 Contributing

See CONTRIBUTING.md for information about contributing to this repository.

📦 Releasing

See RELEASING.md for how packages are published (OIDC trusted publishing from CI — no registry tokens) and how to retry a failed publish.

🔒 Security

See SECURITY.md for reporting security vulnerabilities.

📜 License

This project is licensed under the Apache License, Version 2.0 for new contributions, with existing code under MIT - see the LICENSE file for details.

💬 Community

⭐ Support

If you find MCP servers useful, please consider starring the repository and contributing new servers or improvements!

Managed by Anthropic, but built together with the community. The Model Context Protocol is open source and we encourage everyone to contribute their own servers and improvements!

servers (modelcontextprotocol/servers)

Searching Database…

91.3K ·GitHub
Servers
What is this?This is a collection of reference server implementations for the Model Context Protocol (MCP), showing how to give LLMs secure, controlled access to tools and data sources.
Is this one app or a collection of separate servers?It is a monorepo of several independent reference servers (Everything, Fetch, Filesystem, Git, Memory, Sequential Thinking, Time), each built with an MCP SDK in TypeScript or Python.
How do I run one of these servers?TypeScript-based servers run directly with npx (e.g. starting the Memory server), and Python-based servers run with uvx or pip (e.g. starting the Git server); you then plug the server into an MCP client such as Claude Desktop.
What do I need installed to use these servers?Node.js (for npx) for the TypeScript servers, or uv/uvx (or pip) for the Python servers, plus an MCP-compatible client like Claude Desktop to actually call them.
Are these servers production-ready?No, the maintainers explicitly call them educational reference implementations, not production-ready, and tell developers to evaluate their own security requirements before real use.
Does setup differ on Windows?Yes, on Windows you need to wrap npx-based entries with 'cmd /c' in your client config, while uvx-based Python entries stay unchanged.
What does the 'Everything' server do?It is a reference/test server bundling prompts, resources, and tools together, mainly used to exercise and demonstrate MCP features end-to-end.
Why were servers like GitHub, Slack and PostgreSQL archived?They were moved to a separate servers-archived repo, with several replaced by officially maintained equivalents (e.g. Brave Search by its vendor's own MCP server, Slack now maintained by Zencoder).
How do I build my own MCP server using this repo?Use the official docs at modelcontextprotocol.io for guides and best practices, paired with one of the official SDKs (TypeScript, Python, Go, Java, Kotlin, PHP, Ruby, Rust, Swift, or C#).
What are similar projects?headroom, seo-monster, evenfire, commerce-agents, TetreesAgent_EX, gitagent, wigolo, coral
Which topics is it in?model-context-protocol, reference, anthropic, sdk, mcp-server, claude, agent, mcp, api, tool, apache-2.0, llm
Creator
modelcontextprotocol
Size
31.2 MB
Stars
91.3K
Updated
CommitOct 11Releasev1.0.0Oct 11
Age
1y
Commits · 90 Days