drio
Open app

MCP Server Example

Source

A simple MCP server to search for documentation (tutorial)

Catalog onlyCatalog onlySTDIO

Overview

MCP Server Example is an implementation of a Model Context Protocol (MCP) server designed for educational purposes, demonstrating how to build a functional MCP server that integrates with various LLM clients.

To use the MCP Server Example, follow the tutorial provided in the repository. You will need to install the uv package manager, set up the project, and run the server to accept connections from LLM clients.

  • Standardized way to connect AI models to different data sources and tools. - Supports multiple LLM clients through a client-server architecture. - Provides resources, tools, and prompts for LLMs to utilize.
  1. Integrating various LLM clients with a standardized protocol.
  2. Providing data access to AI applications from local and remote sources.
  3. Facilitating the development of AI tools that require context from multiple data sources.

Add to your AI client

Use these steps to connect MCP Server Example in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server-example-alejandro-ao": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-example-alejandro-ao"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "mcp-server-example-alejandro-ao": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-example-alejandro-ao"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-server-example-alejandro-ao": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-example-alejandro-ao"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-server-example-alejandro-ao": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-example-alejandro-ao"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server-example-alejandro-ao": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-example-alejandro-ao"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-server-example-alejandro-ao": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-example-alejandro-ao"
      ]
    }
  }
}

FAQ

What is MCP?

MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs.

What are the system requirements?

You need Python 3.10 or higher and MCP SDK 1.2.0 or higher.

How do I troubleshoot connection issues?

Check the configuration file path, verify the absolute path, ensure `uv` is installed, and check logs for errors.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":2433,"uuid":"2d335860-f691-4656-9fd5-900635c474b4","name":"mcp-server-example","title":"MCP Server Example","description":"A simple MCP server to search for documentation (tutorial)","avatar_url":"https://avatars.githubusercontent.com/u/18406448?v=4","created_at":"2025-03-13T07:55:44.008Z","updated_at":"2025-03-13T10:12:44.057Z","status":"created","author_name":"alejandro-ao","author_avatar_url":"https://avatars.githubusercontent.com/u/18406448?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/alejandro-ao/mcp-server-example","target":"_self","content":"$29","summary":"$2a","img_url":"https://github.com/alejandro-ao/mcp-server-example/raw/master/img/mcp-diagram-bg.png","type":null,"metadata":"{\"star\":\"78\",\"license\":\"MIT license\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-04-29 12:58:09\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools