MCP Chat

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

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

• Python 3.9+

• Ключ API Anthropic

Related MCP server: MCP Chat Server

Настройка

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

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

CLAUDE_MODEL="claude-sonnet-4-5"
ANTHROPIC_API_KEY=""  # Enter your Anthropic API secret key

# Set to 1 if you're using uv to run the project
# Set to 0 if you're *not* using uv
USE_UV=1

Шаг 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 anthropic 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

Проверка линтинга и типизации

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