Skip to content

Commit 7d51320

Browse files
committed
merge w/ upstream
2 parents c6a2597 + a6bbfa0 commit 7d51320

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

54 files changed

+3535
-1806
lines changed

Diff for: .github/pull_request_template.md

+3-4
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

Diff for: .github/workflows/typescript.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,6 @@ jobs:
7474

7575
- name: Publish package
7676
working-directory: src/${{ matrix.package }}
77-
run: npm publish # --provenance
77+
run: npm publish --access public
7878
env:
7979
NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

Diff for: CONTRIBUTING.md

+7-3
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:
@@ -88,12 +92,12 @@ Documentation improvements are always welcome:
8892

8993
## Community
9094

91-
- Participate in [GitHub Discussions](https://github.com/modelcontextprotocol/servers/discussions)
95+
- Participate in [GitHub Discussions](https://github.com/orgs/modelcontextprotocol/discussions)
9296
- Follow the [Code of Conduct](CODE_OF_CONDUCT.md)
9397

9498
## Questions?
9599

96100
- Check the [documentation](https://modelcontextprotocol.io)
97101
- Ask in GitHub Discussions
98102

99-
Thank you for contributing to MCP Servers!
103+
Thank you for contributing to MCP Servers!

Diff for: README.md

+56-12
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,81 @@
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
27+
28+
## 🤝 Third-Party Servers
29+
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)
35+
- **[Raygun](https://github.com/MindscapeHQ/mcp-server-raygun)** - Interact with your crash reporting and real using monitoring data on your Raygun account
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+
- <img height="12" width="12" src="https://www.tinybird.co/favicon.ico" alt="Tinybird Logo" /> **[Tinybird](https://github.com/tinybirdco/mcp-tinybird)** - Interact with Tinybird serverless ClickHouse platform
39+
- <img height="12" width="12" src="https://pics.fatwang2.com/56912e614b35093426c515860f9f2234.svg" /> [Search1API](https://github.com/fatwang2/search1api-mcp) - One API for Search, Crawling, and Sitemaps
40+
- <img height="12" width="12" src="https://qdrant.tech/img/brand-resources-logos/logomark.svg" /> **[Qdrant](https://github.com/qdrant/mcp-server-qdrant/)** - Implement semantic memory layer on top of the Qdrant vector search engine
41+
42+
### 🌎 Community Servers
43+
44+
A growing set of community-developed and maintained servers demonstrates various applications of MCP across different domains.
45+
46+
> **Note:** Community servers are **untested** and should be used at **your own risk**. They are not affiliated with or endorsed by Anthropic.
47+
48+
- **[MCP Installer](https://github.com/anaisbetts/mcp-installer)** - This server is a server that installs other MCP servers for you.
49+
- **[Spotify MCP](https://github.com/varunneal/spotify-mcp)** - This MCP allows an LLM to play and use Spotify.
50+
- **[Inoyu](https://github.com/sergehuber/inoyu-mcp-unomi-server)** - Interact with an Apache Unomi CDP customer data platform to retrieve and update customer profiles
51+
- **[BigQuery](https://github.com/LucasHild/mcp-server-bigquery)** (by LucasHild) - This server enables LLMs to inspect database schemas and execute queries on BigQuery.
52+
- **[BigQuery](https://github.com/ergut/mcp-bigquery-server)** (by ergut) - Server implementation for Google BigQuery integration that enables direct BigQuery database access and querying capabilities
53+
- **[Todoist](https://github.com/abhiz123/todoist-mcp-server)** - Interact with Todoist to manage your tasks.
54+
- **[Playwright MCP](https://github.com/executeautomation/mcp-playwright)** - This MCP Server will help you run browser automation and webscraping using Playwright
55+
- **[AWS](https://github.com/rishikavikondala/mcp-server-aws)** - Perform operations on your AWS resources using an LLM
56+
- **[LlamaCloud](https://github.com/run-llama/mcp-server-llamacloud)** (by marcusschiesser) - Integrate the data stored in a managed index on [LlamaCloud](https://cloud.llamaindex.ai/)
57+
- **[Any Chat Completions](https://github.com/pyroprompts/any-chat-completions-mcp)** - Interact with any OpenAI SDK Compatible Chat Completions API like OpenAI, Perplexity, Groq, xAI and many more.
58+
59+
## 📚 Resources
60+
61+
Additional resources on MCP.
62+
63+
- **[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)**
64+
- **[Awesome MCP Servers by wong2](https://github.com/wong2/awesome-mcp-servers)** - A curated list of MCP servers by **[wong2](https://github.com/wong2)**
65+
- **[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)**
66+
- **[mcp-get](https://mcp-get.com)** - Command line tool for installing and managing MCP servers by **[Michael Latman](https://github.com/michaellatman)**
2367

2468
## 🚀 Getting Started
2569

2670
### Using MCP Servers in this Repository
27-
Typescript-based servers in this repository can be used directly with `npx`.
71+
Typescript-based servers in this repository can be used directly with `npx`.
2872

2973
For example, this will start the [Memory](src/memory) server:
3074
```sh
3175
npx -y @modelcontextprotocol/server-memory
3276
```
3377

34-
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.
78+
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.
3579

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

0 commit comments

Comments
 (0)