Merge pull request modelcontextprotocol#63 from modelcontextprotocol/zack-lee/quickstart-updates

Phase 1 of documentation revamp: new Quickstart, servers, etc

Author: zckly

docs/first-server/python.mdx

@@ -34,11 +34,11 @@ MCP provides several tools for debugging at different levels:
 
 The Claude.app interface provides basic server status information:
 
-1. Click the 🔌 icon to view:
+1. Click the <img src="/images/claude-desktop-mcp-plug-icon.svg" style={{display: 'inline', margin: 0, height: '1.3em'}} /> icon to view:
    - Connected servers
    - Available prompts and resources
 
-2. Click the 🔨 icon to view:
+2. Click the <img src="/images/claude-desktop-mcp-hammer-icon.svg" style={{display: 'inline', margin: 0, height: '1.3em'}} /> icon to view:
    - Tools made available to the model
 
 ### Viewing logs

docs/first-server/typescript.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.