gremlin_mcp

이 YouTube 튜토리얼 https://www.youtube.com/watch?v=io02ZM0ADqM MCP Full Course for Beginners에서 학습 참고: Copilot이나 다른 LLM에게 기존 도구 코드를 정리하고 유용할 것 같은 다른 도구를 추가하도록 요청했습니다. 파일과 디렉터리를 수정할 수 있는 여러 도구가 있으므로 주의해서 사용해야 합니다. 도구 사용을 제대로 테스트하지 않았습니다. 이 MCP와 적절한 보호 장치를 사용하여 유용한 것을 구축해야 합니다.

에이전트에게 터미널 및 파일 관리 기능을 제공하는 MCP(Model Context Protocol) 서버: 셸/Python 명령 실행, 파일 검색 및 읽기, 파일 및 폴더 생성/편집/삭제.

FastMCP를 기반으로 구축되었습니다.

Tools

서버는 21개의 도구를 제공하며, 다음과 같이 그룹화됩니다:

셸 / Python 실행

검색 및 읽기

파일 및 폴더

Related MCP server: emcp

Requirements

• Python >= 3.13

• fastmcp >= 3.4.7

Installation

uv sync            # recommended
# or
python -m pip install -e .

Starting the server

서버는 FastMCP의 기본 전송 방식인 stdio를 통해 통신합니다. 저장소 루트에서 다음 중 하나로 시작하세요:

uv run python -m gremlin_mcp.main
python test.py serve
python start_gremlin_mcp_server.py

Testing

1. 오프라인 스모크 테스트 (MCP 클라이언트 불필요)

python test.py

서버를 가져와서 모든 도구를 호출하고 (임시 폴더를 생성 및 정리), [PASS]/[FAIL] 요약과 총계를 출력합니다.

2. 대화형 웹 인스펙터

fastmcp dev inspector src/gremlin_mcp/main.py

브라우저에서 MCP Inspector를 열어 도구를 탐색하고, 설명/예제를 읽고, 대화형으로 호출할 수 있습니다.

참고: fastmcp dev는 하위 명령 그룹이므로 inspector 하위 명령을 명시적으로 전달해야 합니다 (fastmcp dev src/...만으로는 실패합니다).

3. 빠른 CLI 확인

fastmcp inspect src/gremlin_mcp/main.py    # server info + tool summary
fastmcp list   src/gremlin_mcp/main.py     # just the tool names

4. MCP 클라이언트에서 연결

편집기/클라이언트의 MCP 구성을 stdio를 통해 서버로 지정하세요. 예:

{
  "mcpServers": {
    "gremlin-mcp": {
      "command": "uv",
      "args": ["run", "python", "-m", "gremlin_mcp.main"]
    }
  }
}

도구 호출 예시

에이전트가 호출하는 방식:

list_dir(path="src")
search_text(pattern="TODO", directory="src")
read_file(file="pyproject.toml")
write_file(file="hello.py", content="print('hi')")
python_code(code="print(6 * 7)")          # -> exit=0 / 42
replace_in_file(path="config.py", old="DEBUG = True", new="DEBUG = False")
tree(path=".", depth=2)

프로젝트 구조

src/gremlin_mcp/
├── __init__.py
├── tools.py   # all tool definitions (21 tools)
└── main.py    # FastMCP server entry point
test.py        # offline smoke test / optional server launcher
start_gremlin_mcp_server.py   # minimal "run the server" launcher

보안 참고 사항

run_command, python_code 및 python_file은 임의의 코드를 실행합니다. 이 서버는 신뢰하는 에이전트/클라이언트에게만 노출하고, 샌드박스 또는 제한된 작업 디렉터리 내에서 실행하는 것을 고려하세요.