MCP Localization Project

# 🚀 MCP-OS CLI 사용 가이드 ## 개요 MCP-OS CLI는 클로드코드 스타일의 터미널 기반 AI 인터페이스입니다. 완전한 로컬 AI 운영체제인 MCP-OS와 Qwen2.5-Coder를 활용하여 터미널에서 직접 AI와 대화하고 코드를 작성할 수 있습니다. ## 설치 및 실행 ### 1. 의존성 설치 ```bash # 가상환경에서 rich 설치 (이미 완료됨) ./venv/bin/pip install rich ``` ### 2. CLI 실행 ```bash # 일반 모드 (AI와 대화) ./venv/bin/python mcp_os_cli.py # 테스트 모드 (시스템 상태 확인) ./venv/bin/python mcp_os_cli.py --test # 도움말 ./venv/bin/python mcp_os_cli.py --help ``` ## 주요 기능 ### 🤖 AI 채팅 - 메시지를 입력하면 AI와 실시간 대화 - 마크다운 형식 응답 지원 - 코드 하이라이팅 자동 적용 ``` 💬 파이썬으로 피보나치 수열을 만들어줘 🤖 AI: 다음은 피보나치 수열을 생성하는 파이썬 코드입니다: ```python def fibonacci(n): if n <= 1: return n return fibonacci(n-1) + fibonacci(n-2) ``` ### 📝 파일 관리 ```bash # 파일 열기 및 편집 /file script.py /file /path/to/file.txt # 새 파일 생성 /file new_script.py ``` ### 🏃 명령 실행 ```bash # 시스템 명령 실행 (30초 타임아웃) /run ls -la /run python script.py /run git status ``` ### 🔧 MCP 도구 사용 ```bash # 사용 가능한 MCP 도구 목록 /mcp # 특정 도구 사용 /mcp debug script.py /mcp browser https://example.com /mcp compress "긴 텍스트를 압축" /mcp research "머신러닝" ``` ## 명령어 목록 | 명령어 | 설명 | 예시 | |--------|------|------| | `/help` | 도움말 표시 | `/help` | | `/file <경로>` | 파일 열기/편집 | `/file script.py` | | `/run <명령>` | 시스템 명령 실행 | `/run ls -la` | | `/mcp <도구>` | MCP 도구 사용 | `/mcp debug` | | `/exit` | CLI 종료 | `/exit` | ## 특징 ### 🎨 Rich 출력 - 컬러풀한 터미널 출력 - 문법 하이라이팅 - 마크다운 렌더링 - 프로그레스 바 ### 🔒 안전 기능 - 30초 명령 실행 타임아웃 - 1시간 세션 타임아웃 - Ctrl+C 안전 종료 - 예외 처리 ### 🚀 성능 - Mock 모드 지원 (MCP-OS 없이도 실행) - 비동기 AI 응답 처리 - 실시간 출력 ## 사용 예시 ### 1. 기본 사용법 ```bash $ ./venv/bin/python mcp_os_cli.py ╭─────────────────────────────────────────────────────────────╮ │ 🚀 MCP-OS CLI Interface │ │ 클로드코드 스타일 로컬 AI CLI │ ├─────────────────────────────────────────────────────────────┤ │ 💬 AI와 대화하기: 메시지 입력 │ │ 📝 파일 편집: /file <경로> │ │ 🏃 명령 실행: /run <명령> │ │ 🔧 MCP 도구: /mcp <도구명> │ │ ❓ 도움말: /help │ │ 👋 종료: /exit │ ╰─────────────────────────────────────────────────────────────╯ 💬 안녕하세요! 파이썬 웹 스크래핑 코드를 작성해주세요. ``` ### 2. 파일 편집 ```bash 💬 /file scraper.py 📁 파일 열기: scraper.py # 파일이 없으면 생성 옵션 제공 # 파일이 있으면 내용 표시 후 편집 옵션 제공 ``` ### 3. 명령 실행 ```bash 💬 /run python scraper.py 🏃 명령 실행: python scraper.py 📤 출력: 웹 스크래핑 완료! ✅ 명령 실행 완료 ``` ## 문제 해결 ### Mock 모드 실행 MCP-OS 시스템이 초기화되지 않은 경우 Mock 모드로 실행되며, 기본적인 AI 대화와 파일 관리 기능을 사용할 수 있습니다. ### 타임아웃 오류 - 명령 실행: 30초 제한 - 전체 세션: 1시간 제한 - 필요시 Ctrl+C로 강제 종료 ### 의존성 오류 ```bash # Rich 라이브러리 미설치 시 ./venv/bin/pip install rich # MCP-OS 모듈 오류 시 Mock 모드로 자동 전환 ``` ## 확장 기능 향후 추가 예정인 기능: - 실제 MCP-OS 시스템 완전 연동 - 고급 디버깅 도구 - 브라우저 자동화 - 컨텍스트 압축 - 연구 정책 엔진 --- **버전**: 1.0.0 **최종 업데이트**: 2025-01-20 **호환성**: Python 3.8+, Linux/macOS/Windows