Skip to main content
Glama

MCP 서버

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

기능

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

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

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

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

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

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

Related MCP server: mcp-toolkit

도구

도구

설명

today

오늘 날짜와 시간 가져오기

add

두 숫자 더하기

web_search

실시간 웹 정보 검색

fetch_content

URL을 스크래핑하여 콘텐츠 추출

list_files

파일 및 디렉토리 목록 표시

read_file

행 단위 윈도우를 사용하여 파일 읽기

write_file

파일에 텍스트 쓰기

append_to_file

기존 파일에 텍스트 추가

replace_in_file

파일 내 텍스트 찾기 및 교체

insert_after_marker

마커 라인 뒤에 텍스트 삽입

run_command

샌드박스에서 셸 명령 실행

설치

# 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 라이선스

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A general-purpose MCP server providing web search, persistent memory storage, and secure code execution capabilities. It enables AI agents to search the web, store and retrieve data, and run Python/JavaScript code in sandboxed environments.
      8
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A comprehensive MCP server enabling LLMs to execute commands, manage files, interact with Figma, search the web, generate images, and more, extending their capabilities beyond text generation.
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      A secure, production-grade MCP server that provides filesystem operations, AST math evaluation, and system diagnostics for LLM agents.
      MIT