Example

Научитесь создавать сервер Model Context Protocol (MCP) с Example. Интегрируйте LLM с источниками данных, включайте вызовы функций и используйте готовые шаблоны. Подключайтесь к Claude Desktop!

Инструменты разработчика Разработка API Обучение и документация ★ 157 GitHub (157 ★)

Этот репозиторий содержит учебную реализацию сервера Model Context Protocol (MCP), показывающую, как создать сервер, способный интегрироваться с различными LLM-клиентами. Он иллюстрирует основные концепции MCP, включая ресурсы, инструменты и промпты, а также предоставляет практический пример подключения к хост-приложению, такому как Claude Desktop. Проект предназначен для помощи разработчикам в понимании и реализации MCP-серверов для предоставления контекста моделям ИИ.

Ключевые возможности

01Предоставляет клиентам доступ к данным в виде файлов

02Позволяет LLM выполнять вызовы функций с одобрения пользователя

03Предлагает готовые шаблоны для конкретных задач

04Демонстрирует интеграцию с Claude Desktop

05Использует клиент-серверную архитектуру

Варианты использования

01Создание собственного MCP-сервера для предоставления доступа к определённым возможностям.

02Подключение локальных и удалённых источников данных к LLM.

03Предоставление контекста LLM через стандартизированные протоколы.

MCP Server Example

This repository contains an implementation of a Model Context Protocol (MCP) server for educational purposes. This code demonstrates how to build a functional MCP server that can integrate with various LLM clients.

To follow the complete tutorial, please refer to theYouTube video tutorial.

What is MCP?

MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs. Think of MCP like a USB-C port for AI applications - it provides a standardized way to connect AI models to different data sources and tools.

Key Benefits

A growing list of pre-built integrations that your LLM can directly plug into
Flexibility to switch between LLM providers and vendors
Best practices for securing your data within your infrastructure

Architecture Overview

MCP follows a client-server architecture where a host application can connect to multiple servers:

MCP Hosts: Programs like Claude Desktop, IDEs, or AI tools that want to access data through MCP
MCP Clients: Protocol clients that maintain 1:1 connections with servers
MCP Servers: Lightweight programs that expose specific capabilities through the standardized Model Context Protocol
Data Sources: Both local (files, databases) and remote services (APIs) that MCP servers can access

Core MCP Concepts

MCP servers can provide three main types of capabilities:

Resources: File-like data that can be read by clients (like API responses or file contents)
Tools: Functions that can be called by the LLM (with user approval)
Prompts: Pre-written templates that help users accomplish specific tasks

System Requirements

Python 3.10 or higher
MCP SDK 1.2.0 or higher
uv package manager

Getting Started

Installing uv Package Manager

On MacOS/Linux:

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.

Project Setup

Create and initialize the project:

# Create a new directory for our project
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

Create the server implementation file:

touch main.py

Running the Server

Start the MCP server:

uv run main.py

The server will start and be ready to accept connections

Connecting to Claude Desktop

Install Claude Desktop from the official website
Configure Claude Desktop to use your MCP server:

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
    "mcpServers": {
        "mcp-server": {
            "command": "uv",  # It's better to use the absolute path to the uv command
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/YOUR/mcp-server",
                "run",
                "main.py"
            ]
        }
    }
}

Restart Claude Desktop

Troubleshooting

If your server isn't being picked up by Claude Desktop:

Check the configuration file path and permissions
Verify the absolute path in the configuration is correct
Ensure uv is properly installed and accessible
Check Claude Desktop logs for any error messages

License

This project is licensed under the MIT License. See the LICENSE file for details.

MCP сервер: практический пример

Это репозиторий с реализацией MCP-сервера (Model Context Protocol) для образовательных целей. Код демонстрирует, как создать рабочий MCP-сервер, который можно интегрировать с различными LLM-клиентами.

Полный туториал доступен на YouTube: видео-руководство.

Что такое MCP?

MCP (Model Context Protocol) — это открытый протокол, который стандартизирует передачу контекста LLM. Его можно сравнить с USB-C для AI-приложений: единый способ подключения моделей к разным источникам данных и инструментам.

Ключевые преимущества:

Готовые интеграции, к которым LLM подключается напрямую
Возможность легко переключаться между провайдерами LLM
Лучшие практики безопасности данных в вашей инфраструктуре

Архитектура

MCP использует клиент-серверную архитектуру:

MCP Host — программа (Claude Desktop, IDE, AI-инструмент), которая хочет получить данные через MCP
MCP Client — протокольный клиент, поддерживающий соединение 1:1 с сервером
MCP Server — лёгкий сервер, предоставляющий специфические возможности через стандартизированный протокол
Источники данных — локальные (файлы, БД) и удалённые сервисы (API), к которым MCP-сервер обращается

Основные возможности MCP-сервера

MCP-сервер может предоставлять три типа возможностей:

Resources — данные, которые клиент может прочитать (например, ответы API, содержимое файлов)
Tools — функции, вызываемые LLM (с разрешения пользователя)
Prompts — готовые шаблоны для типовых задач

Системные требования

Python 3.10 или новее
MCP SDK 1.2.0 или новее
Пакетный менеджер uv

Установка

Установка uv

macOS / Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

После установки перезапустите терминал, чтобы команда uv стала доступна.

Создание проекта

# Создайте директорию
uv init mcp-server
cd mcp-server

# Виртуальное окружение
uv venv
source .venv/bin/activate  # На Windows: .venv\Scripts\activate

# Установите зависимости
uv add "mcp[cli]" httpx

Создайте файл сервера:

touch main.py

Запуск сервера

uv run main.py

Сервер запустится и будет готов принимать подключения.

Подключение к Claude Desktop

Установите Claude Desktop с официального сайта.
Отредактируйте конфигурационный файл Claude Desktop:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Пример содержимого:

{
  "mcpServers": {
    "mcp-server": {
      "command": "/full/path/to/uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/YOUR/mcp-server",
        "run",
        "main.py"
      ]
    }
  }
}

Перезапустите Claude Desktop.

Поиск и устранение неисправностей

Если Claude Desktop не видит сервер:

Проверьте путь к файлу конфигурации и права доступа
Убедитесь, что в args указан абсолютный путь к вашему проекту
Проверьте, что uv установлен корректно (используйте полный путь до команды)
Просмотрите логи Claude Desktop на предмет ошибок

Лицензия

Проект распространяется под лицензией MIT. Подробнее — в файле LICENSE.

Источник: https://mcpmarket.com/server/example

Example

Ключевые возможности

Варианты использования

MCP Server Example

What is MCP?

Key Benefits

Architecture Overview

Core MCP Concepts

System Requirements

Getting Started

Installing uv Package Manager

Project Setup

Running the Server

Connecting to Claude Desktop

Troubleshooting

License

MCP сервер: практический пример

Что такое MCP?

Архитектура

Основные возможности MCP-сервера

Системные требования

Установка

Установка uv

Создание проекта

Запуск сервера

Подключение к Claude Desktop

Поиск и устранение неисправностей

Лицензия

Какие основные возможности может предоставить MCP-сервер?

Как подключить мой MCP-сервер к Claude Desktop?

Какие системные требования для запуска Example MCP-сервера?

Что такое MCP?

Каковы ключевые преимущества использования MCP?

Комментарии