MCP Chat

MCP Chat은 Anthropic API를 통해 AI 모델과 대화형 채팅 기능을 제공하는 명령줄 인터페이스 애플리케이션입니다. 이 애플리케이션은 문서 검색, 명령 기반 프롬프트, 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 패키지 설치 프로그램이자 해석기(resolver)입니다.

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_server.py 변경 사항을 디버깅하기 위해 MCP Web inspector를 보려면 다음을 실행합니다:

uv run mcp dev mcp_server.py

사용법

기본 상호 작용

메시지를 입력하고 Enter를 눌러 모델과 채팅하세요.

문서 검색

@ 기호 다음에 문서 ID를 입력하여 쿼리에 문서 내용을 포함하세요:

> Tell me about @deposition.md

명령

/ 접두사를 사용하여 MCP 서버에 정의된 명령을 실행하세요:

> /summarize deposition.md

Tab을 누르면 명령이 자동 완성됩니다.

개발

새 문서 추가

mcp_server.py 파일을 편집하여 docs 사전에 새 문서를 추가하세요.

MCP 기능 구현

MCP 기능을 완전히 구현하려면:

1. mcp_server.py의 TODO를 완료하세요.

2. mcp_client.py에서 누락된 기능을 구현하세요.

린트 및 타입 검사

린트 및 타입 검사는 구현되어 있지 않습니다.