Skip to content

Commit b6d04b9

Browse files
authored
Merge branch 'main' into patch-1
2 parents 63d6fec + 65e35d3 commit b6d04b9

File tree

33 files changed

+1633
-1500
lines changed

33 files changed

+1633
-1500
lines changed

.github/pull_request_template.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@
33
## Description
44

55
## Server Details
6-
<!-- If modifying an existing server or adding a new one, provide details -->
7-
- Server: <!-- e.g., filesystem, github, new-server-name -->
6+
<!-- If modifying an existing server, provide details -->
7+
- Server: <!-- e.g., filesystem, github -->
88
- Changes to: <!-- e.g., tools, resources, prompts -->
99

1010
## Motivation and Context
@@ -18,7 +18,6 @@
1818

1919
## Types of changes
2020
<!-- What types of changes does your code introduce? Put an `x` in all the boxes that apply: -->
21-
- [ ] New MCP Server
2221
- [ ] Bug fix (non-breaking change which fixes an issue)
2322
- [ ] New feature (non-breaking change which adds functionality)
2423
- [ ] Breaking change (fix or feature that would cause existing functionality to change)
@@ -27,7 +26,7 @@
2726
## Checklist
2827
<!-- Go over all the following points, and put an `x` in all the boxes that apply. -->
2928
- [ ] I have read the [MCP Protocol Documentation](https://modelcontextprotocol.io)
30-
- [ ] My server follows MCP security best practices
29+
- [ ] My changes follows MCP security best practices
3130
- [ ] I have updated the server's README accordingly
3231
- [ ] I have tested this with an LLM client
3332
- [ ] My code follows the repository's style guidelines

CONTRIBUTING.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,16 @@ Thank you for your interest in contributing to the Model Context Protocol (MCP)
55
## Types of Contributions
66

77
### 1. New Servers
8-
Adding a new server is a valuable way to contribute. Before creating a new server:
8+
9+
The repository contains reference implementations, as well as a list of community servers.
10+
We generally don't accept new servers into the repository. We do accept pull requests to the [README.md](./README.md)
11+
adding a reference to your servers.
912

1013
- Check the [modelcontextprotocol.io](https://modelcontextprotocol.io) documentation
1114
- Ensure your server doesn't duplicate existing functionality
1215
- Consider whether your server would be generally useful to others
1316
- Follow [security best practices](https://modelcontextprotocol.io/docs/concepts/transports#security-considerations) from the MCP documentation
17+
- Create a PR adding a link to your server to the [README.md](./README.md).
1418

1519
### 2. Improvements to Existing Servers
1620
Enhancements to existing servers are welcome! This includes:

README.md

Lines changed: 42 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,43 +1,70 @@
1-
# MCP servers
1+
# Model Context Protocol servers
22

3-
A collection of reference implementations and community-contributed servers for the [Model Context Protocol](https://modelcontextprotocol.io/) (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 tools and data sources.
3+
This repository is a collection of *reference implementations* for the [Model Context Protocol](https://modelcontextprotocol.io/) (MCP), as well as references
4+
to community built servers and additional resources.
45

6+
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.
57
Each MCP server is implemented with either the [Typescript MCP SDK](https://github.com/modelcontextprotocol/typescript-sdk) or [Python MCP SDK](https://github.com/modelcontextprotocol/python-sdk).
68

7-
## 🌟 Featured Servers
9+
## 🌟 Reference Servers
810

11+
These servers aim to demonstrate MCP features and the Typescript and Python SDK.
12+
13+
- **[Brave Search](src/brave-search)** - Web and local search using Brave's Search API
14+
- **[Fetch](src/fetch)** - Web content fetching and conversion for efficient LLM usage
915
- **[Filesystem](src/filesystem)** - Secure file operations with configurable access controls
1016
- **[GitHub](src/github)** - Repository management, file operations, and GitHub API integration
1117
- **[GitLab](src/gitlab)** - GitLab API, enabling project management
1218
- **[Git](src/git)** - Tools to read, search, and manipulate Git repositories
1319
- **[Google Drive](src/gdrive)** - File access and search capabilities for Google Drive
14-
- **[PostgreSQL](src/postgres)** - Read-only database access with schema inspection
15-
- **[Sqlite](src/sqlite)** - Database interaction and business intelligence capabilities
16-
- **[Slack](src/slack)** - Channel management and messaging capabilities
17-
- **[Sentry](src/sentry)** - Retrieving and analyzing issues from Sentry.io
20+
- **[Google Maps](src/google-maps)** - Location services, directions, and place details
1821
- **[Memory](src/memory)** - Knowledge graph-based persistent memory system
22+
- **[PostgreSQL](src/postgres)** - Read-only database access with schema inspection
1923
- **[Puppeteer](src/puppeteer)** - Browser automation and web scraping
20-
- **[Brave Search](src/brave-search)** - Web and local search using Brave's Search API
21-
- **[Google Maps](src/google-maps)** - Location services, directions, and place details
22-
- **[Fetch](src/fetch)** - Web content fetching and conversion for efficient LLM usage
24+
- **[Sentry](src/sentry)** - Retrieving and analyzing issues from Sentry.io
25+
- **[Slack](src/slack)** - Channel management and messaging capabilities
26+
- **[Sqlite](src/sqlite)** - Database interaction and business intelligence capabilities
2327

24-
## 🌎 Community Servers
28+
## 🤝 Third-Party Servers
2529

26-
- **[Cloudflare](https://github.com/cloudflare/mcp-server-cloudflare)** - Deploy, configure & interrogate your resources on the Cloudflare developer platform (e.g. Workers/KV/R2/D1)
30+
### 🎖️ Official Integrations
31+
32+
Official integrations are maintained by companies building production ready MCP servers for their platforms.
33+
34+
- <img height="12" width="12" src="https://cdn.simpleicons.org/cloudflare" /> **[Cloudflare](https://github.com/cloudflare/mcp-server-cloudflare)** - Deploy, configure & interrogate your resources on the Cloudflare developer platform (e.g. Workers/KV/R2/D1)
2735
- **[Raygun](https://github.com/MindscapeHQ/mcp-server-raygun)** - Interact with your crash reporting and real using monitoring data on your Raygun account
28-
- **[E2B](https://github.com/e2b-dev/mcp-server)** - Run code in secure sandboxes hosted by [E2B](https://e2b.dev)
36+
- <img height="12" width="12" src="https://e2b.dev/favicon.ico" alt="E2B Logo" /> **[E2B](https://github.com/e2b-dev/mcp-server)** - Run code in secure sandboxes hosted by [E2B](https://e2b.dev)
37+
- **[Neon](https://github.com/neondatabase/mcp-server-neon)** - Interact with the Neon serverless Postgres platform
38+
- **[Tinybird](https://github.com/tinybirdco/mcp-tinybird)** - Interact with Tinybird serverless ClickHouse platform
39+
40+
### 🌎 Community Servers
41+
42+
A growing set of community-developed and maintained servers demonstrates various applications of MCP across different domains.
43+
44+
> **Note:** Community servers are **untested** and should be used at **your own risk**. They are not affiliated with or endorsed by Anthropic.
45+
46+
- **[MCP Installer](https://github.com/anaisbetts/mcp-installer)** - This server is a server that installs other MCP servers for you.
47+
48+
## 📚 Resources
49+
50+
Additional resources on MCP.
51+
52+
- **[Awesome MCP Servers by punkpeye](https://github.com/punkpeye/awesome-mcp-servers)** - A curated list of MCP servers by **[Frank Fiegel](https://github.com/punkpeye)**
53+
- **[Awesome MCP Servers by wong2](https://github.com/wong2/awesome-mcp-servers)** - A curated list of MCP servers by **[wong2](https://github.com/wong2)**
54+
- **[Awesome MCP Servers by appcypher](https://github.com/appcypher/awesome-mcp-servers)** - A curated list of MCP servers by **[Stephen Akinyemi](https://github.com/appcypher)**
55+
- **[mcp-get](https://mcp-get.com)** - Command line tool for installing and managing MCP servers by **[Michael Latman](https://github.com/michaellatman)**
2956

3057
## 🚀 Getting Started
3158

3259
### Using MCP Servers in this Repository
33-
Typescript-based servers in this repository can be used directly with `npx`.
60+
Typescript-based servers in this repository can be used directly with `npx`.
3461

3562
For example, this will start the [Memory](src/memory) server:
3663
```sh
3764
npx -y @modelcontextprotocol/server-memory
3865
```
3966

40-
Python-based servers in this repository can be used directly with [`uvx`](https://docs.astral.sh/uv/concepts/tools/) or [`pip`](https://pypi.org/project/pip/). `uvx` is recommended for ease of use and setup.
67+
Python-based servers in this repository can be used directly with [`uvx`](https://docs.astral.sh/uv/concepts/tools/) or [`pip`](https://pypi.org/project/pip/). `uvx` is recommended for ease of use and setup.
4168

4269
For example, this will start the [Git](src/git) server:
4370
```sh

0 commit comments

Comments
 (0)