File System MCP Server (with LLM Agent Bridge)
이 프로젝트는 파일 시스템 작업을 LLM(예: Ollama) + MCP 도구 + Python 브리지(Agent)로 자동화하는 예제입니다.
아키텍처(최신 구조)
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ 사용자 │ → │ bridge.py │ → │ mcp_server.py │ → │ backend_api.py│
│ (자연어 명령)│ │ (LLM+MCP Agent)│ │ (MCP 서버) │ │ (백엔드 API) │
└──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘
- bridge.py: Ollama(LLM)와 MCP 서버를 연결하는 Python 에이전트(Agent, 브리지)
- mcp_server.py: MCP 프로토콜을 구현한 파일 시스템 도구 서버
- backend_api.py: 실제 파일 시스템 작업을 수행하는 백엔드 API
주요 파일 설명
backend_api.py: 파일/디렉토리 관리 REST API (포트 8001)mcp_server.py: MCP 프로토콜 서버, backend_api.py를 래핑 (포트 8000)bridge.py: Ollama(LLM)와 MCP 서버를 연결, 자연어 명령을 실제 작업으로 자동 실행
설치 및 실행 방법
1. 의존성 설치
pip install -r requirements.txt
2. 서비스 실행
1) 백엔드 API 실행
python backend_api.py
2) MCP 서버 실행
python mcp_server.py
3) Ollama 서버 실행
ollama serve
4) 브리지(Agent) 실행
python bridge.py
사용 예시 (자동화)
브리지 실행 후, 아래와 같이 자연어로 명령하면 실제 파일 시스템 작업이 자동 실행됩니다.
👤 사용자: test_source.txt를 test_dest.txt로 복사해줘
🤖 Ollama 처리 중...
📝 Ollama 응답:
{"tool": "copy_file", "inputs": {"source_path": "test_source.txt", "destination_path": "test_dest.txt"}}
🔧 MCP 도구 호출: copy_file
📋 매개변수: {'source_path': 'test_source.txt', 'destination_path': 'test_dest.txt'}
✅ 실행 결과:
{
"output": {
"source_path": "/Users/terzeron/workspace/mcp_test/test_source.txt",
"destination_path": "/Users/terzeron/workspace/mcp_test/test_dest.txt",
"bytes_copied": 94,
"message": "File copied successfully"
}
}
- 예시 명령:
현재 디렉토리 파일 목록 보여줘test_source.txt 파일 읽어줘새 파일 test.txt에 Hello World 써줘test_source.txt 파일 정보 보여줘새 폴더 backup 만들어줘test_source.txt를 test_copy.txt로 복사해줘test_copy.txt 파일 삭제해줘
Ollama 단독 사용법(참고)
Ollama만 사용할 경우, 실제 작업은 자동 실행되지 않고 curl 명령어 예시만 출력됩니다. 실제 자동화를 원한다면 반드시 bridge.py를 사용하세요.
기타
- 모든 서비스는 로컬에서 실행됩니다.
- bridge.py는 Ollama의 답변에서 도구 호출 JSON을 추출해 MCP 서버에 자동 요청합니다.
- MCP 서버와 백엔드 API는 FastAPI 기반입니다.
문의/확장
- 더 복잡한 에이전트, 대화형 챗봇, 여러 도구 조합 등 확장도 가능합니다.