MCP Chat

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

Инструменты: Управляется моделью: Claude решает, когда их вызывать. Результаты использует Claude. Используется для:

• предоставления Claude дополнительной функциональности

Ресурсы: Управляется приложением: Наше приложение решает, когда их вызывать. Результаты в основном использует наше приложение. Используется для

• получения данных в наше приложение

• добавления контекста к сообщениям

Промпты: Управляется пользователем: Пользователь решает, когда их использовать. Используется для:

• предопределённых рабочих процессов, запускаемых на основе пользовательского ввода, например слэш-команда, нажатие кнопки или пункт меню.

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

• Python 3.9+

• Ключ Anthropic API

Related MCP server: mcp-doc-chat

Настройка

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

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

ANTHROPIC_API_KEY=""  # Enter your Anthropic API secret key

Шаг 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. Запустите проект

uv run main.py

ИЛИ

python main.py

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

uv run mcp dev mcp_server.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

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

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