Added examples
This commit is contained in:
Zachary Lee
parent
f674086dee
commit
9109d03fa6
7 changed files with 217 additions and 41 deletions
123
examples.mdx
Normal file
123
examples.mdx
Normal file
|
|
@ -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.
|
||||
|
|
@ -44,7 +44,7 @@ flowchart LR
|
|||
|
||||
Choose the path that best fits your needs:
|
||||
|
||||
<CardGroup cols={1}>
|
||||
<CardGroup cols={2}>
|
||||
<Card
|
||||
title="Quickstart"
|
||||
icon="bolt"
|
||||
|
|
@ -52,6 +52,13 @@ Choose the path that best fits your needs:
|
|||
>
|
||||
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
|
||||
|
|
|
|||
|
|
@ -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",
|
||||
|
|
|
|||
|
|
@ -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"
|
||||
|
|
|
|||
22
servers.mdx
22
servers.mdx
|
|
@ -1,22 +0,0 @@
|
|||
---
|
||||
title: "Servers"
|
||||
description: "A list of featured servers and directories"
|
||||
---
|
||||
|
||||
This page provides a continuously updated list of featured MCP servers and directories made by the community.
|
||||
|
||||
## Featured servers
|
||||
|
||||
- Cloudflare: https://github.com/cloudflare/mcp-server-cloudflare
|
||||
- Firebase Genkit: https://github.com/firebase/genkit/tree/main/js/plugins/mcp
|
||||
- Neon Database: https://github.com/neondatabase/mcp-server-neon
|
||||
|
||||
## Server directories
|
||||
|
||||
### MCP servers repository
|
||||
|
||||
For a list of servers built and maintained by the MCP team, check out our official [servers repository on Github](https://github.com/modelcontextprotocol/servers).
|
||||
|
||||
### MCP Get
|
||||
|
||||
MCP Get is the largest community-led directory of MCP servers. You can find it here: https://mcp-get.com/
|
||||
|
|
@ -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"
|
||||
|
|
|
|||
73
tutorials/building-mcp-with-claude.mdx
Normal file
73
tutorials/building-mcp-with-claude.mdx
Normal file
|
|
@ -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.
|
||||
Loading…
Reference in a new issue