Added examples

zckly · zckly · commit 9109d03fa66d · 2024-12-10T18:26:18.000-05:00
diff --git a/examples.mdx 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": "<YOUR_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.
diff --git a/introduction.mdx b/introduction.mdx
@@ -44,14 +44,21 @@ flowchart LR
 
 Choose the path that best fits your needs:
 
-<CardGroup cols={1}>
+<CardGroup cols={2}>
   <Card
     title="Quickstart"
     icon="bolt"
     href="/quickstart"
   >
     Build and connect to your first MCP server
   </Card>
+  <Card
+    title="Examples"
+    icon="grid"
+    href="/examples"
+  >
+    Check out our gallery of official MCP servers and implementations
+  </Card>
 </CardGroup>
 
 ## Tutorials
@@ -64,6 +71,13 @@ Choose the path that best fits your needs:
   >
     Learn how to build your first MCP client
   </Card>
+  <Card
+    title="Building MCP with Claude"
+    icon="comments"
+    href="/building-a-client"
+  >
+    Learn how to use Claude to speed up your MCP development
+  </Card>
 </CardGroup>
 
 ## Explore MCP
diff --git 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
@@ -1067,20 +1067,13 @@ If Claude attempts to use the tools but they fail:
 
 ## Next steps
 
-<CardGroup cols={2}>
+<CardGroup cols={1}>
   <Card
     title="Building a client"
     icon="outlet"
     href="/tutorials/building-a-client"
   >
     Learn how to build your an MCP client that can connect to your server
-  </Card>
-   <Card
-    title="Building a local fileserver"
-    icon="files"
-    href="/examples"
-  >
-   Build an intermediate MCP server that communicates with your local filesystem
   </Card>
   <Card
     title="Example servers"
@@ -1089,7 +1082,6 @@ If Claude attempts to use the tools but they fail:
   >
     Check out our gallery of official MCP servers and implementations
   </Card>
- 
    <Card
     title="Core architecture"
     icon="sitemap"
diff --git a/servers.mdx b/servers.mdx
diff --git a/tutorials/building-a-client.mdx b/tutorials/building-a-client.mdx
@@ -855,13 +855,6 @@ node build/client.js C:\\projects\\mcp-server\\weather.js
 ## Next steps
 
 <CardGroup cols={1}>
-   <Card
-    title="Building a local fileserver"
-    icon="files"
-    href="/examples"
-  >
-   Build an intermediate MCP server that communicates with your local filesystem
-  </Card>
   <Card
     title="Example servers"
     icon="grid"
diff --git a/tutorials/building-mcp-with-claude.mdx b/tutorials/building-mcp-with-claude.mdx
@@ -0,0 +1,73 @@
+---
+title: "Building MCP with Claude"
+description: "Speed up your MCP development with Claude!"
+---
+
+This guide will help you use Claude to build custom Model Context Protocol (MCP) servers and clients.
+
+## Preparing the documentation
+
+Before starting, gather the necessary documentation to help Claude understand MCP:
+
+1. Visit https://modelcontextprotocol.io/llms-full.txt and copy the full documentation text
+2. Navigate to either the [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk) or [Python SDK repository](https://github.com/modelcontextprotocol/python-sdk)
+3. Copy the README files and other relevant documentation
+4. Paste these documents into your conversation with Claude
+
+## Describing your server
+
+Once you've provided the documentation, clearly describe to Claude what kind of server you want to build. Be specific about:
+
+- What resources your server will expose
+- What tools it will provide
+- Any prompts it should offer
+- What external systems it needs to interact with
+
+For example:
+```
+Build an MCP server that:
+- Connects to my company's PostgreSQL database
+- Exposes table schemas as resources
+- Provides tools for running read-only SQL queries
+- Includes prompts for common data analysis tasks
+```
+
+## Working with Claude
+
+When working with Claude on MCP servers:
+
+1. Start with the core functionality first, then iterate to add more features
+2. Ask Claude to explain any parts of the code you don't understand
+3. Request modifications or improvements as needed
+4. Have Claude help you test the server and handle edge cases
+
+Claude can help implement all the key MCP features:
+
+- Resource management and exposure
+- Tool definitions and implementations
+- Prompt templates and handlers
+- Error handling and logging
+- Connection and transport setup
+
+## Best practices
+
+When building MCP servers with Claude:
+
+- Break down complex servers into smaller pieces
+- Test each component thoroughly before moving on
+- Keep security in mind - validate inputs and limit access appropriately
+- Document your code well for future maintenance
+- Follow MCP protocol specifications carefully
+
+## Next steps
+
+After Claude helps you build your server:
+
+1. Review the generated code carefully
+2. Test the server with the MCP Inspector tool
+3. Connect it to Claude.app or other MCP clients
+4. Iterate based on real usage and feedback
+
+Remember that Claude can help you modify and improve your server as requirements change over time.
+
+Need more guidance? Just ask Claude specific questions about implementing MCP features or troubleshooting issues that arise.

Original file line number	Diff line number	Diff line change
`@@ -40,11 +40,14 @@`
`40`	`40`	`"navigation": [`
`41`	`41`	`{`
`42`	`42`	`"group": "Get Started",`
`43`		`- "pages": ["introduction", "quickstart"]`
	`43`	`+ "pages": ["introduction", "quickstart", "examples"]`
`44`	`44`	`},`
`45`	`45`	`{`
`46`	`46`	`"group": "Tutorials",`
`47`		`- "pages": ["tutorials/building-a-client"]`
	`47`	`+ "pages": [`
	`48`	`+ "tutorials/building-a-client",`
	`49`	`+ "tutorials/building-mcp-with-claude"`
	`50`	`+ ]`
`48`	`51`	`},`
`49`	`52`	`{`
`50`	`53`	`"group": "Concepts",`