Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@GPT MCP Serversearch for TODO comments in my project folder"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
GPT MCP Server
ChatGPT Desktop에서 로컬 파일시스템에 직접 접근
MCP (Model Context Protocol) 기반 파일시스템 서버
개요
이 서버를 실행하면 ChatGPT Desktop에서 로컬 파일을 읽고 검색할 수 있습니다.
ChatGPT Pro (클라우드)
↓
ngrok (터널)
↓
이 MCP 서버 (로컬)
↓
로컬 파일시스템기능
도구 | 설명 |
| 디렉토리 파일 목록 조회 |
| 파일 내용 읽기 |
| 파일 내용 검색 |
| 파일 메타데이터 조회 |
| 접근 가능 디렉토리 확인 |
보안
화이트리스트 기반: 허용된 디렉토리만 접근 가능
민감 파일 차단:
.env,*.key,*secret*등 자동 차단읽기 전용: 기본적으로 쓰기 비활성화
파일 크기 제한: 10MB 초과 파일 차단
빠른 시작
1. 서버 실행
# Windows (배치 파일)
start.bat
# 또는 PowerShell
.\start.ps1
# 또는 직접 실행
python server.py2. ngrok 터널링
새 터미널에서:
ngrok http 8765출력 예시:
Forwarding: https://abc123.ngrok-free.app -> http://localhost:87653. ChatGPT에 등록
ChatGPT Desktop → Settings → Developer Mode 활성화
MCP Connectors → Add Connector
ngrok URL 입력:
https://abc123.ngrok-free.app/mcp
설치
요구사항
Python 3.10+
GPT Pro 구독 (Developer Mode 필요)
ngrok (무료 계정)
설치 단계
# 1. 디렉토리 이동
cd gpt-mcp-server
# 2. 가상환경 생성
python -m venv venv
# 3. 가상환경 활성화 (Windows)
venv\Scripts\activate
# 4. 의존성 설치
pip install -r requirements.txt
# 5. 설정 파일 수정 (선택)
# config.yaml에서 allowed_directories 수정설정
config.yaml
# 허용된 디렉토리 (이 폴더 내의 파일만 접근 가능)
filesystem:
allowed_directories:
- "C:\\Users\\your-username\\Documents"
- "C:\\Projects"
# 파일 크기 제한 (바이트)
max_file_size: 10485760 # 10MB
# 쓰기 모드 (기본: 비활성화)
write_enabled: false환경 변수로 설정
# 허용 디렉토리 (세미콜론으로 구분)
set GPT_MCP_ALLOWED_DIRS=C:\Users\me\Documents;C:\Projects
# 포트 변경
set GPT_MCP_PORT=8080
# 디버그 모드
set GPT_MCP_DEBUG=true사용 예시
ChatGPT에서 다음과 같이 요청:
"Documents 폴더의 파일 목록을 보여줘"
"project/src 폴더에서 'import' 가 포함된 파일을 찾아줘"
"README.md 파일을 읽어줘"
"config.yaml 파일의 1-50 라인만 보여줘"프로젝트 구조
gpt-mcp-server/
├── server.py # MCP 서버 메인
├── security.py # 보안 레이어
├── config.py # 설정 관리
├── tools.py # 고급 파일 도구
├── config.yaml # 설정 파일
├── requirements.txt # Python 의존성
├── start.bat # Windows 실행 스크립트
├── start.ps1 # PowerShell 실행 스크립트
├── README.md # 이 문서
└── PLANNING.md # 설계 문서문제 해결
"Connection refused" 오류
# 서버가 실행 중인지 확인
curl http://127.0.0.1:8765/health"Access denied" 오류
config.yaml에서 allowed_directories에 해당 경로가 포함되어 있는지 확인.
ngrok 연결 안 됨
ngrok 재시작
새 URL 생성됨 → ChatGPT에 다시 등록
한글 파일명 깨짐
# config.yaml
server:
log_level: "DEBUG"인코딩 문제 로그 확인 후 encoding 파라미터 조정.
API 엔드포인트
엔드포인트 | 설명 |
| 서버 상태 |
| 헬스체크 |
| MCP JSON-RPC 엔드포인트 |
| SSE 스트림 |
라이선스
MIT License
DreamTeam 설계
이 프로젝트는 DreamTeam 전문가들의 설계를 기반으로 구현되었습니다:
Dr. Michael Torres (Solution Architect): 시스템 아키텍처
James Park (Backend Lead): FastAPI 서버 구현
Robert Chen (Security Lead): 보안 레이어
Kevin Zhang (DevOps Lead): 실행 스크립트 및 설정
Emily Brown (Technical Writer): 문서화
"로컬 파일에 직접 접근하는 GPT"
Claude Code처럼, 하지만 GPT로.
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.