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
Что это?Это набор эталонных реализаций серверов для Model Context Protocol (MCP), которые показывают, как дать языковым моделям (LLM) безопасный и контролируемый доступ к инструментам и источникам данных.
Это одно приложение или набор отдельных серверов?Это монорепозиторий из нескольких независимых эталонных серверов (Everything, Fetch, Filesystem, Git, Memory, Sequential Thinking, Time), каждый из которых написан с помощью MCP SDK на TypeScript или Python.
Как мне запустить один из этих серверов?Серверы на TypeScript запускаются напрямую через npx (например, запуск сервера Memory), а серверы на Python — через uvx или pip (например, запуск сервера Git). Затем сервер подключается к MCP-клиенту, например Claude Desktop.
Что нужно установить, чтобы пользоваться этими серверами?Для серверов на TypeScript нужен Node.js (для npx), для серверов на Python — uv/uvx (или pip). Кроме того, нужен MCP-совместимый клиент, например Claude Desktop, чтобы действительно вызывать серверы.
Эти серверы готовы к продакшену?Нет. Мейнтейнеры прямо называют их учебными эталонными реализациями, не предназначенными для продакшена, и советуют разработчикам самостоятельно оценивать требования безопасности перед реальным использованием.
Отличается ли настройка в Windows?Да, в Windows записи с npx в конфигурации клиента нужно обернуть в 'cmd /c', а записи для серверов на Python с uvx остаются без изменений.
Что делает сервер 'Everything'?Это эталонный и тестовый сервер, который объединяет промпты, ресурсы и инструменты. В основном его используют, чтобы проверять и демонстрировать возможности MCP от начала до конца.
Почему серверы GitHub, Slack и PostgreSQL были архивированы?Их перенесли в отдельный репозиторий servers-archived, а некоторые заменили официально поддерживаемыми аналогами: например, Brave Search — собственным MCP-сервером его поставщика, а Slack теперь поддерживается компанией Zencoder.
Как мне создать собственный MCP-сервер на основе этого репозитория?Используйте официальную документацию на modelcontextprotocol.io, где есть руководства и лучшие практики, и один из официальных SDK: TypeScript, Python, Go, Java, Kotlin, PHP, Ruby, Rust, Swift или 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