From 9109d03fa66de6570afbde83fc7371927ac649cc Mon Sep 17 00:00:00 2001 From: Zachary Lee Date: Tue, 10 Dec 2024 18:26:18 -0500 Subject: [PATCH] Added examples --- examples.mdx | 123 +++++++++++++++++++++++++ introduction.mdx | 16 +++- mint.json | 7 +- quickstart.mdx | 10 +- servers.mdx | 22 ----- tutorials/building-a-client.mdx | 7 -- tutorials/building-mcp-with-claude.mdx | 73 +++++++++++++++ 7 files changed, 217 insertions(+), 41 deletions(-) create mode 100644 examples.mdx delete mode 100644 servers.mdx create mode 100644 tutorials/building-mcp-with-claude.mdx diff --git a/examples.mdx b/examples.mdx new file mode 100644 index 0000000..dd02c28 --- /dev/null +++ b/examples.mdx @@ -0,0 +1,123 @@ +--- +title: Examples +description: 'A list of example servers and implementations' +--- + +This page showcases various Model Context Protocol (MCP) servers that demonstrate the protocol's capabilities and versatility. These servers enable Large Language Models (LLMs) to securely access tools and data sources. + +## Reference implementations + +These official reference servers demonstrate core MCP features and SDK usage: + +### Data and file systems +- **[Filesystem](src/filesystem)** - Secure file operations with configurable access controls +- **[PostgreSQL](src/postgres)** - Read-only database access with schema inspection capabilities +- **[SQLite](src/sqlite)** - Database interaction and business intelligence features +- **[Google Drive](src/gdrive)** - File access and search capabilities for Google Drive + +### Development tools +- **[Git](src/git)** - Tools to read, search, and manipulate Git repositories +- **[GitHub](src/github)** - Repository management, file operations, and GitHub API integration +- **[GitLab](src/gitlab)** - GitLab API integration enabling project management +- **[Sentry](src/sentry)** - Retrieving and analyzing issues from Sentry.io + +### Web and browser automation +- **[Brave Search](src/brave-search)** - Web and local search using Brave's Search API +- **[Fetch](src/fetch)** - Web content fetching and conversion optimized for LLM usage +- **[Puppeteer](src/puppeteer)** - Browser automation and web scraping capabilities + +### Productivity and communication +- **[Slack](src/slack)** - Channel management and messaging capabilities +- **[Google Maps](src/google-maps)** - Location services, directions, and place details +- **[Memory](src/memory)** - Knowledge graph-based persistent memory system + +### AI and specialized tools +- **[EverArt](src/everart)** - AI image generation using various models +- **[Sequential Thinking](src/sequentialthinking)** - Dynamic problem-solving through thought sequences +- **[AWS KB Retrieval](src/aws-kb-retrieval)** - Retrieval from AWS Knowledge Base using Bedrock Agent Runtime + +## Official integrations + +These MCP servers are maintained by companies for their platforms: + +- **[Axiom](https://github.com/axiomhq/mcp-server-axiom)** - Query and analyze logs, traces, and event data using natural language +- **[Browserbase](https://github.com/browserbase/mcp-server-browserbase)** - Automate browser interactions in the cloud +- **[Cloudflare](https://github.com/cloudflare/mcp-server-cloudflare)** - Deploy and manage resources on the Cloudflare developer platform +- **[E2B](https://github.com/e2b-dev/mcp-server)** - Execute code in secure cloud sandboxes +- **[Neon](https://github.com/neondatabase/mcp-server-neon)** - Interact with the Neon serverless Postgres platform +- **[Obsidian Markdown Notes](https://github.com/calclavia/mcp-obsidian)** - Read and search through Markdown notes in Obsidian vaults +- **[Qdrant](https://github.com/qdrant/mcp-server-qdrant/)** - Implement semantic memory using the Qdrant vector search engine +- **[Raygun](https://github.com/MindscapeHQ/mcp-server-raygun)** - Access crash reporting and monitoring data +- **[Search1API](https://github.com/fatwang2/search1api-mcp)** - Unified API for search, crawling, and sitemaps +- **[Tinybird](https://github.com/tinybirdco/mcp-tinybird)** - Interface with the Tinybird serverless ClickHouse platform + +## Community highlights + +A growing ecosystem of community-developed servers extends MCP's capabilities: + +- **[Docker](https://github.com/ckreiling/mcp-server-docker)** - Manage containers, images, volumes, and networks +- **[Kubernetes](https://github.com/Flux159/mcp-server-kubernetes)** - Manage pods, deployments, and services +- **[Linear](https://github.com/jerhadf/linear-mcp-server)** - Project management and issue tracking +- **[Snowflake](https://github.com/datawiz168/mcp-snowflake-service)** - Interact with Snowflake databases +- **[Spotify](https://github.com/varunneal/spotify-mcp)** - Control Spotify playback and manage playlists +- **[Todoist](https://github.com/abhiz123/todoist-mcp-server)** - Task management integration + +> **Note:** Community servers are untested and should be used at your own risk. They are not affiliated with or endorsed by Anthropic. + +For a complete list of community servers, visit the [MCP Servers Repository](https://github.com/modelcontextprotocol/servers). + +## Getting started + +### Using reference servers + +TypeScript-based servers can be used directly with `npx`: + +```bash +npx -y @modelcontextprotocol/server-memory +``` + +Python-based servers can be used with `uvx` (recommended) or `pip`: + +```bash +# Using uvx +uvx mcp-server-git + +# Using pip +pip install mcp-server-git +python -m mcp_server_git +``` + +### Configuring with Claude + +To use an MCP server with Claude, add it to your configuration: + +```json +{ + "mcpServers": { + "memory": { + "command": "npx", + "args": ["-y", "@modelcontextprotocol/server-memory"] + }, + "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": "" + } + } + } +} +``` + +## Additional resources + +- [MCP Servers Repository](https://github.com/modelcontextprotocol/servers) - Complete collection of reference implementations and community servers +- [Awesome MCP Servers](https://github.com/punkpeye/awesome-mcp-servers) - Curated list of MCP servers +- [MCP CLI](https://github.com/wong2/mcp-cli) - Command-line inspector for testing MCP servers +- [MCP Get](https://mcp-get.com) - Tool for installing and managing MCP servers + +Visit our [GitHub Discussions](https://github.com/orgs/modelcontextprotocol/discussions) to engage with the MCP community. \ No newline at end of file diff --git a/introduction.mdx b/introduction.mdx index bc4d829..82a70a6 100644 --- a/introduction.mdx +++ b/introduction.mdx @@ -44,7 +44,7 @@ flowchart LR Choose the path that best fits your needs: - + Build and connect to your first MCP server + + Check out our gallery of official MCP servers and implementations + ## Tutorials @@ -64,6 +71,13 @@ Choose the path that best fits your needs: > Learn how to build your first MCP client + + Learn how to use Claude to speed up your MCP development + ## Explore MCP diff --git a/mint.json b/mint.json index bb77082..3a9dc52 100644 --- a/mint.json +++ b/mint.json @@ -40,11 +40,14 @@ "navigation": [ { "group": "Get Started", - "pages": ["introduction", "quickstart"] + "pages": ["introduction", "quickstart", "examples"] }, { "group": "Tutorials", - "pages": ["tutorials/building-a-client"] + "pages": [ + "tutorials/building-a-client", + "tutorials/building-mcp-with-claude" + ] }, { "group": "Concepts", diff --git a/quickstart.mdx b/quickstart.mdx index a9a9335..6dc01f3 100644 --- a/quickstart.mdx +++ b/quickstart.mdx @@ -1067,20 +1067,13 @@ If Claude attempts to use the tools but they fail: ## Next steps - + Learn how to build your an MCP client that can connect to your server - - - Build an intermediate MCP server that communicates with your local filesystem Check out our gallery of official MCP servers and implementations - - - Build an intermediate MCP server that communicates with your local filesystem -