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.