MCP 서버

FastAPI로 구축된 모듈형 모델 컨텍스트 프로토콜(MCP) 서버로, LLM 상호작용을 위한 도구를 제공합니다.

기능

• 모듈형 아키텍처 - 각 도구를 쉽게 유지 관리 가능

• 파일 작업 - 파일 읽기, 쓰기, 추가, 교체 및 텍스트 삽입

• 웹 검색 - DDGS를 사용하여 실시간 웹 검색

• URL 가져오기 - 웹 콘텐츠 스크래핑 및 요약

• 명령 실행 - 샌드박스 환경에서 셸 명령 실행

• 엄격한 격리 - 일회용 /tmp를 사용하는 Bubblewrap 샌드박스

Related MCP server: mcp-toolkit

도구

설치

# Clone the repository
git clone <repository-url>
cd mcp_server

# Install dependencies using uv
uv sync

사용법

# Start the server
python main.py

서버는 http://0.0.0.0:8000에서 시작됩니다.

아키텍처

mcp_server/
├── main.py              # FastAPI application entry point
├── tools.json           # Tool definitions (JSON schema)
└── tools/               # Tool implementations
    ├── __init__.py      # Exports all handlers
    ├── add.py           # Math operations
    ├── today.py         # Date/time
    ├── web_search.py    # Web search
    ├── fetch_content.py # URL scraping
    ├── files.py         # All file operations
    └── run_command.py   # Shell command execution

샌드박스 구성

run_command 도구는 격리를 위해 bubblewrap을 사용합니다:

• 읽기 전용 루트 파일 시스템 (--ro-bind / /)

• 일회용 임시 디렉토리 (--tmpfs /tmp)

• 쓰기 가능한 리소스 디렉토리 (--bind resources resources)

• DNS 확인 활성화 (/etc 제한 없음)

면책 조항

이 프로젝트는 Alibaba Group의 Tongyi Lab에서 개발한 대규모 언어 모델인 Qwen 3.6의 도움을 받아 개발되었습니다. 코드 생성, 문서화 및 리팩토링 과정에서 AI의 도움을 받았지만, 모든 기술적 결정과 최종 구현은 인간 개발자가 검토하고 검증했습니다.

라이선스

MIT 라이선스