본문 바로가기
WIKI 기술 지식 베이스

MCP 서버 통합

원문 보기 위키 갱신

AgentFS를 MCP (Model Context Protocol) 서버로 실행하면 Claude Desktop 같은 AI 어시스턴트에 파일시스템과 키-값 작업을 노출할 수 있어요.

출처: 문서

본문

MCP 서버 시작하기

agentfs serve mcp my-agent

이 명령은 stdio를 통해 AgentFS 도구를 노출하는 MCP 서버를 시작해요.

사용 가능한 도구

파일시스템 도구

도구 설명
read_file 파일 내용 읽기
write_file 파일 내용 쓰기
readdir 디렉터리 내용 나열
mkdir 디렉터리 생성
remove 파일 또는 디렉터리 삭제
rename 파일 또는 디렉터리 이름 변경
stat 파일 메타데이터 조회
access 파일 접근 권한 확인

키-값 도구

도구 설명
kv_get 키로 값 조회
kv_set 키-값 쌍 설정
kv_delete 키 삭제
kv_list 모든 키 나열

노출 도구 제한하기

보안을 위해 사용 가능한 도구를 제한할 수 있어요:

# Read-only mode
agentfs serve mcp my-agent --tools read_file,readdir,stat,kv_get,kv_list

# Filesystem only
agentfs serve mcp my-agent --tools read_file,write_file,readdir,mkdir,remove

# Key-value only
agentfs serve mcp my-agent --tools kv_get,kv_set,kv_delete,kv_list

보안 고려 사항

MCP 서버는 AI 어시스턴트에게 AgentFS 파일시스템에 대한 직접 접근 권한을 줘요. 다음 보안 수칙을 참고하세요:

  • 도구 제한 - 어시스턴트에게 필요한 도구만 노출하기
  • 오버레이 사용 - 실제 디렉터리 접근 대신 오버레이 파일시스템 만들기
  • 에이전트 데이터베이스 검토 - .agentfs/*.db를 주기적으로 확인하기

디버깅

MCP 서버가 잘 작동하는지 확인하기:

# Run manually to see output
agentfs serve mcp my-agent

# Check if the database exists
ls -la .agentfs/my-agent.db

더 알아보기 (Learn more)