MCP Workspace Server

제어된 로컬 작업 공간 안의 파일에 AI 에이전트가 안전하고 구조화된 방식으로 접근할 수 있게 해 주는 경량 Python MCP 서버입니다.

개요

AI 에이전트는 종종 로컬 파일에 저장된 프로젝트 컨텍스트에 접근해야 합니다. 에이전트에게 제한 없는 파일 시스템 접근을 허용하면 불필요한 보안 위험이 발생합니다.

이 프로젝트는 Model Context Protocol (MCP)을 사용하여 구성된 디렉터리로의 접근을 제한하면서 제어된 작업 공간 도구의 작은 집합을 제공합니다.

Related MCP server: Files MCP Server

MCP 도구

서버는 세 가지 도구를 제공합니다.

list_workspace_files

구성된 작업 공간 내부에서 사용할 수 있는 파일을 나열합니다.

read_text_file

크기 제한을 구성할 수 있는 UTF-8 텍스트 파일을 읽습니다.

search_text

작업 공간 문서를 검색하고 일치하는 파일 이름, 줄 번호, 텍스트를 반환합니다.

보안

서버는 요청된 경로를 정의된 작업 공간 루트를 기준으로 확인하고 해당 디렉터리 밖으로의 경로 탐색을 방지합니다.

추가 안전 장치는 다음과 같습니다.

• 제한된 작업 공간 접근

• 입력 검증

• 파일 크기 제한

• UTF-8 처리

• 경로 탐색 방지

• 자동화된 보안 테스트

프로젝트 구조

mcp-workspace-server/
├── src/
│   └── mcp_workspace_server/
│       ├── __init__.py
│       └── server.py
├── tests/
│   └── test_paths.py
├── workspace/
│   └── example.txt
├── pyproject.toml
└── README.md