Образец сервера MCP

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

Схема МКП

Пример сервера MCP

Ссылки:

Что такое МКП?

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

Основные преимущества

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

Обзор архитектуры

MCP следует архитектуре клиент-сервер, где хост-приложение может подключаться к нескольким серверам:

Хосты MCP : программы, такие как Claude Desktop, IDE или инструменты ИИ, которым требуется доступ к данным через MCP.
Клиенты MCP : клиенты протокола, поддерживающие соединения 1:1 с серверами.
Серверы MCP : легкие программы, которые предоставляют определенные возможности через стандартизированный протокол контекста модели.
Источники данных : как локальные (файлы, базы данных), так и удаленные службы (API), к которым могут получить доступ серверы MCP.

Основные концепции MCP

Серверы MCP могут предоставлять три основных типа возможностей:

Ресурсы : Файлоподобные данные, которые могут быть прочитаны клиентами (например, ответы API или содержимое файлов)
Инструменты : функции, которые может вызывать LLM (с одобрения пользователя)
Подсказки : готовые шаблоны, помогающие пользователям выполнять определенные задачи.

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

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

Установка

Добавление MCP в ваш проект Python Мы рекомендуем использовать uv для управления вашими проектами Python.

Если вы еще не создали проект с управлением UV, создайте его:

uv init mcp-server-sample
cd mcp-server-sample

Затем добавьте MCP к зависимостям вашего проекта:

uv add "mcp[cli]

Альтернативный вариант для проектов, использующих pip для зависимостей:

pip install "mcp[cli]"

Запуск автономных инструментов разработки MCP Чтобы запустить команду mcp с uv:

uv run mcp

Быстрый старт

Давайте создадим простой MCP-сервер, который предоставляет калькулятор и некоторые данные:

# server.py
from mcp.server.fastmcp import FastMCP

# Create an MCP server
mcp = FastMCP("Demo")


# Add an addition tool
@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b


# Add a dynamic greeting resource
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"

Вы можете установить этот сервер в Claude Desktop и сразу же взаимодействовать с ним, выполнив:

mcp install server.py

Кроме того, вы можете протестировать его с помощью MCP Inspector:

mcp dev server.py

Сделано с ❤️ Антонио Скапеллато

Ресурсы:

Создание агентов с использованием протокола контекста модели — полный семинар с Махешем Мурагом из Anthropic

Лицензия

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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

Образовательная реализация сервера Model Context Protocol, демонстрирующая, как создать функциональный сервер MCP, интегрирующийся с различными клиентами LLM.

Пример сервера MCP

Related MCP Servers

MCP-Guide
qpd-v
A
security
A
license
A
quality
A beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts, provides interactive examples, and lists available MCP servers. This server is designed to be a helpful companion for developers working with MCP. Also comes with a huge list of servers you can install.
Last updated -
3
9
36
JavaScript
Apache 2.0
MCP Server Example
alejandro-ao
A
security
A
license
A
quality
An educational implementation of a Model Context Protocol server that demonstrates how to build a functional MCP server for integrating with various LLM clients like Claude Desktop.
Last updated -
1
88
Python
MIT License
URL Fetch MCP
aelaguiz
-
security
A
license
-
quality
A Model Context Protocol (MCP) server that enables Claude or other LLMs to fetch content from URLs, supporting HTML, JSON, text, and images with configurable request parameters.
Last updated -
Python
MIT License
MCP Maker
CaptainCrouton89
-
security
-
license
-
quality
A specialized server that helps users create new Model Context Protocol (MCP) servers by providing tools and templates for scaffolding projects with various capabilities.
Last updated -
1
TypeScript

View all related MCP servers

MCP Server Sample