MCP Server Example

@alejandro-ao

About MCP Server Example

A simple MCP server to search for documentation (tutorial)

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-example": {
      "command": "uv",
      "args": [
        "init",
        "mcp-server"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Server Example?

MCP Server Example is an educational implementation of a Model Context Protocol (MCP) server that demonstrates how to build functional MCP servers for integration with LLM clients. It is intended for developers learning to expose data and tools through the standardized MCP protocol using Python.

How to use MCP Server Example?

Install the uv package manager, create a project with uv init mcp-server, activate the virtual environment, install dependencies with uv add "mcp[cli]" httpx, and create main.py. Run the server with uv run main.py. Then configure an MCP host like Claude Desktop by editing its configuration file to point to the server using the uv command and absolute path to the project directory.

Key features of MCP Server Example

Demonstrates MCP Resources, Tools, and Prompts
Example implementation in Python 3.10+
Uses the official MCP SDK (1.2.0+)
Connects to Claude Desktop and other MCP hosts
Serves as a tutorial companion for a video guide

Use cases of MCP Server Example

Learning how to build an MCP server from scratch
Prototyping custom tools and data access for LLMs
Testing MCP client configurations (e.g., Claude Desktop)
Understanding the MCP client-server architecture

FAQ from MCP Server Example

What is MCP?

MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs, similar to a USB-C port for AI applications.

What are the system requirements?

Python 3.10 or higher, MCP SDK 1.2.0 or higher, and the uv package manager.

How do I connect this server to Claude Desktop?

Install Claude Desktop, then edit ~/Library/Application Support/Claude/claude_desktop_config.json to include a server entry with command: "uv" and args containing --directory, the absolute path to your project, run, and main.py. Restart Claude Desktop.

What capabilities does the server provide?

The server can expose three main types of MCP capabilities: Resources (file-like data), Tools (callable functions), and Prompts (pre-written templates).

What should I do if the server isn't picked up by Claude Desktop?

Check the configuration file path and permissions, verify the absolute path is correct, ensure uv is installed and accessible, and review Claude Desktop logs for error messages.

Frequently asked questions

What is MCP?

MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs, similar to a USB-C port for AI applications.

What are the system requirements?

Python 3.10 or higher, MCP SDK 1.2.0 or higher, and the `uv` package manager.

How do I connect this server to Claude Desktop?

Install Claude Desktop, then edit `~/Library/Application Support/Claude/claude_desktop_config.json` to include a server entry with `command: "uv"` and `args` containing `--directory`, the absolute path to your project, `run`, and `main.py`. Restart Claude Desktop.

What capabilities does the server provide?

The server can expose three main types of MCP capabilities: Resources (file-like data), Tools (callable functions), and Prompts (pre-written templates).

What should I do if the server isn't picked up by Claude Desktop?

Check the configuration file path and permissions, verify the absolute path is correct, ensure `uv` is installed and accessible, and review Claude Desktop logs for error messages.

Comments

Basic information

More Other MCP servers

IDA Pro MCP

mrexodia

AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.

9.9K

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K