mirror of
https://github.com/modelcontextprotocol/servers.git
synced 2026-04-17 23:53:24 +02:00
92 lines
3.2 KiB
Markdown
92 lines
3.2 KiB
Markdown
# MCP servers
|
|
|
|
A collection of reference implementations and community-contributed servers for the Model Context Protocol (MCP). This repository showcases the versatility and extensibility of MCP, demonstrating how it can be used to give Large Language Models (LLMs) secure, controlled access to external tools and data sources.
|
|
|
|
## 🌟 Featured Servers
|
|
|
|
- **[Filesystem](src/filesystem)** - Secure file operations with configurable access controls
|
|
- **[GitHub](src/github)** - Repository management, file operations, and GitHub API integration
|
|
- **[Google Drive](src/gdrive)** - File access and search capabilities for Google Drive
|
|
- **[PostgreSQL](src/postgres)** - Read-only database access with schema inspection
|
|
- **[Slack](src/slack)** - Channel management and messaging capabilities
|
|
- **[Memory](src/memory)** - Knowledge graph-based persistent memory system
|
|
- **[Puppeteer](src/puppeteer)** - Browser automation and web scraping
|
|
- **[Brave Search](src/brave-search)** - Web and local search using Brave's API
|
|
- **[Google Maps](src/google-maps)** - Location services, directions, and place details
|
|
|
|
## 🚀 Getting Started
|
|
|
|
The servers in this repository can be used directly with `npx`. For example:
|
|
|
|
```sh
|
|
npx -y @modelcontextprotocol/server-memory
|
|
```
|
|
|
|
This will start the [Memory](src/memory) server. However, this isn't very useful on its own, and should instead be configured into an MCP client. For example, here's the Claude Desktop configuration to use the above server:
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"memory": {
|
|
"command": "npx",
|
|
"args": ["-y", "@modelcontextprotocol/server-memory"]
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
Additional examples might look like:
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"filesystem": {
|
|
"command": "npx",
|
|
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
|
|
},
|
|
"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"]
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## 🛠️ Creating Your Own Server
|
|
|
|
Interested in creating your own MCP server? Visit the official documentation at [modelcontextprotocol.io](https://modelcontextprotocol.io/introduction) for comprehensive guides, best practices, and technical details on implementing MCP servers.
|
|
|
|
## 🤝 Contributing
|
|
|
|
See [CONTRIBUTING.md](CONTRIBUTING.md) for information about contributing to the MCP servers repository.
|
|
|
|
## 🔒 Security
|
|
|
|
See [SECURITY.md](SECURITY.md) for reporting security vulnerabilities.
|
|
|
|
## 📜 License
|
|
|
|
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|
|
|
|
## 💬 Community
|
|
|
|
- [GitHub Discussions](https://github.com/modelcontextprotocol/servers/discussions)
|
|
|
|
## ⭐ Support
|
|
|
|
If you find MCP servers useful, please consider:
|
|
- Starring the repository
|
|
- Contributing new servers or improvements
|
|
- Sharing your experience with the community
|
|
|
|
---
|
|
|
|
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!
|