Advertise
MCP.so
Sign In

MCP Server Example

@alejandro-ao

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

alejandro-ao

About MCP Server Example

A simple MCP server to search for documentation (tutorial)

MCP Server Example config

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

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

MCP Server Example tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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.

2

What are the system requirements?

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

3

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.

4

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).

5

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

More Other MCP servers

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K
Advertise