mcp-server-example

A simple MCP server to search for documentation (tutorial)

GitHub Stars

127

User Rating

Not Rated

Favorites

0

Views

22

Forks

49

Issues

6

Installation
Difficulty
Beginner
Estimated Time
5-10 minutes

Installation

Installation

Prerequisites

Please specify required software and versions:
Python: 3.10 or higher
MCP SDK: 1.2.0 or higher
uv package manager

Installation Steps

1. Install uv Package Manager

On MacOS/Linux:
bash
curl -LsSf https://astral.sh/uv/install.sh | sh
Make sure to restart your terminal afterwards to ensure that the uv command gets picked up.

2. Project Setup

1Create and initialize the project:
bash
uv init mcp-server
cd mcp-server

Create virtual environment and activate it

uv venv source .venv/bin/activate # On Windows use: .venv\Scripts\activate

Install dependencies

uv add "mcp[cli]" httpx

3. Create the server implementation file:

bash
touch main.py

4. Start the MCP server:

bash
uv run main.py
The server will start and be ready to accept connections.

Troubleshooting

Common Issues

Issue: Server won't start Solution: Check Python version and reinstall dependencies. Issue: Not recognized by LLM client Solution: Verify configuration file path and syntax.

Additional Resources