MCP (Model Context Protocol) Server

Примеры интеграции MCP (протокол контекста модели)

В этом репозитории демонстрируется использование протокола контекста модели (MCP) с различными интеграциями, включая сервер пользовательского калькулятора, GitHub и Google Maps.

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

Model Context Protocol (MCP) — это протокол, который позволяет моделям ИИ взаимодействовать с внешними инструментами и службами. Он предоставляет стандартизированный способ для моделей ИИ:

• Выполнение инструментов и функций
• Доступ к ресурсам
• Генерировать подсказки
• Взаимодействие с внешними службами

Структура проекта

├── server.py # MCP сервер (создание на заказ)
├── client_server.py # Клиент MCP
├── 1)maps.py # Интеграция Google Maps MCP
├── 2)github.py # Интеграция GitHub MCP
└── requirements.txt # Зависимости проекта

Функции

1. Пользовательский сервер калькуляторов

• Реализует основные арифметические операции
• Демонстрирует создание инструмента MCP
• Демонстрирует ресурсы и оперативное управление

2. Интеграция с GitHub

• Список коммитов репозитория
• Использует GitHub Personal Access Token для аутентификации
• Демонстрирует обработку переменных окружения

3. Интеграция с Google Картами

• Поиск мест с помощью Google Maps API
• Настраиваемый радиус поиска
• Управление ключами API на основе переменных среды

Настраивать

1. Установить зависимости:

pip install -r требования.txt

Типы инструментов MCP

1. Инструменты : функции, выполняющие определенные действия.
   • Определено с помощью декоратора @mcp.tool
   • Может принимать параметры и возвращать значения
2. Ресурсы : статические или динамические источники данных
   • Определено с помощью декоратора @mcp.resource
   • Доступ осуществляется с использованием URL-адресов ресурсов
3. Подсказки : Генерация текста на основе шаблона
   • Определено с помощью декоратора @mcp.prompt
   • Может включать динамический контент

Лучшие практики

1. Всегда используйте переменные среды для конфиденциальных данных
2. Реализуйте правильную обработку ошибок
3. Используйте подсказки по типам дл�� большей ясности кода
4. Документируйте свои инструменты с помощью понятных строк документации
5. Храните ключи API в безопасности и никогда не передавайте их в систему контроля версий.

Примеры использования

Калькулятор

Серверная часть (инициализация)

@mcp.tool(имя="добавить")
def add(a: int, b: int): вернуть a + b

Запуск файла server.py запустит сервер MCP.

Клиентская сторона (использование)

результат = ожидание сеанса.call_tool("add", arguments={"a": 5, "b": 3})

Запустив файл client_server.py , он подключится к серверу MCP.