MCP Chat

MCP Chat — это приложение с интерфейсом командной строки, которое обеспечивает интерактивное общение с ИИ-моделями через Google Gemini API. Приложение поддерживает поиск документов, командные запросы и расширяемые интеграции инструментов через архитектуру MCP (Model Control Protocol).

Предварительные требования

• Python 3.9+

• API-ключ Google Gemini

Related MCP server: MCP Chat

Настройка

Шаг 1: Настройка переменных окружения

1. Создайте или отредактируйте файл .env в корне проекта и убедитесь, что следующие переменные заданы корректно:

GEMINI_API_KEY=""  # Enter your Google Gemini API key
GEMINI_MODEL="gemini-3.6-flash"  # The Gemini model to use

Вы можете сгенерировать API-ключ в Google AI Studio.

Шаг 2: Установка зависимостей

Вариант 1: Настройка с помощью uv (рекомендуется)

uv — это быстрый установщик и резолвер пакетов Python.

1. Установите uv, если он ещё не установлен:

pip install uv

2. Создайте и активируйте виртуальное окружение:

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

3. Установите зависимости:

uv pip install -e .

4. Запустите проект

uv run main.py

Вариант 2: Настройка без uv

1. Создайте и активируйте виртуальное окружение:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

2. Установите зависимости:

pip install google-genai python-dotenv prompt-toolkit "mcp[cli]==1.8.0"

3. Запустите проект

python main.py

Использование

Базовое взаимодействие

Просто введите сообщение и нажмите Enter, чтобы общаться с моделью.

Поиск документов

Используйте символ @ с идентификатором документа, чтобы включить содержимое документа в запрос:

> Tell me about @deposition.md

Команды

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

> /summarize deposition.md

Команды будут автоматически дополняться при нажатии Tab.

Разработка

Добавление новых документов

Отредактируйте файл mcp_server.py, чтобы добавить новые документы в словарь docs.

Реализация функций MCP

Чтобы полностью реализовать функции MCP:

1. Завершите TODO в mcp_server.py

2. Реализуйте недостающую функциональность в mcp_client.py

Линтинг и проверка типов

Проверки линтера и типов не реализованы.