MCP 도구

Claude Desktop 및 기타 LLM 클라이언트를 위한 파일 시스템 및 명령 실행 도구를 제공하는 맞춤형 MCP(Model Context Protocol) 서버 구현입니다.

모델 컨텍스트 프로토콜이란 무엇인가요?

모델 컨텍스트 프로토콜(MCP)은 애플리케이션이 대규모 언어 모델(LLM)에 컨텍스트를 제공하는 방식을 표준화하는 개방형 프로토콜입니다. USB-C 포트가 다양한 주변 기기에 장치를 연결하는 표준화된 방식을 제공하는 것처럼, MCP는 AI 모델을 다양한 데이터 소스 및 도구에 연결하는 표준화된 방식을 제공합니다.

이 프로젝트는 Claude와 다른 LLM이 로컬 파일 시스템과 상호 작용하고 명령을 실행할 수 있도록 하는 여러 유용한 도구를 갖춘 FastMCP 서버를 구현합니다. 잘 정의된 도구 인터페이스를 통해 LLM의 로컬 시스템 접근 기능을 제어된 방식으로 확장합니다.

Related MCP server: Claude TypeScript MCP Servers

MCP의 주요 이점

표준화된 통합 : MCP는 LLM이 직접 연결할 수 있는 미리 구축된 통합의 목록을 제공합니다.
공급업체 유연성 : LLM 공급업체와 공급업체(Claude, GPT-4o, Gemini 등) 간에 쉽게 전환할 수 있습니다.
보안 : 인프라 내 데이터 보안을 위한 모범 사례
도구 노출 : 기존 도구를 캡슐화하고 모든 MCP 호환 LLM 클라이언트에서 액세스할 수 있도록 합니다.

특징

MCP 서버는 다음과 같은 파일 시스템과 명령 실행 도구를 제공합니다.

execute_shell_command : 셸 명령을 실행하고 stdout/stderr 결과를 얻습니다.
show_file : 선택적 줄 범위 지정을 사용하여 파일 내용을 봅니다.
search_in_file : 정규 표현식을 사용하여 파일에서 패턴을 검색합니다.
edit_file : 문자열 교체 및 줄 작업으로 파일을 정확하게 변경합니다.
write_file : 파일에 내용을 쓰거나 추가합니다.

MCP 아키텍처

MCP는 클라이언트-서버 아키텍처를 따릅니다.

호스트 : 연결을 시작하는 LLM 애플리케이션(예: Claude Desktop 또는 IDE)
클라이언트 : 호스트 애플리케이션 내부에서 서버와 1:1 연결을 유지합니다.
서버 : 클라이언트에게 컨텍스트, 도구 및 프롬프트를 제공합니다(이 프로젝트는 서버를 구현합니다)

필수 조건

Python 3.10 이상
MCP 호환 클라이언트(Claude Desktop 또는 MCP를 지원하는 다른 클라이언트)

설치

uv 설치
이 저장소를 복제하거나 소스 코드를 다운로드하세요
MCP 서버를 설치하려면 uv run mcp install 실행하세요.
uv 실행 파일의 절대 경로를 얻으려면 which uv 를 실행하세요.
Claude Desktop에서 MCP 서버 구성을 업데이트하여 uv 실행 파일의 절대 경로를 사용하세요.

내 MCP 서버 구성은 다음과 같습니다.

지엑스피1

용법

Claude Desktop에서 연결

클로드 데스크톱 열기
식별자 "zbigniew-mcp"를 사용하여 MCP 서버에 연결합니다.

참고 : 이 구현은 Claude Desktop에 초점을 맞추고 있지만, MCP는 모든 MCP 호환 도구나 LLM 클라이언트와 호환되도록 설계되어 구현 및 통합에 있어 유연성을 제공합니다.

사용 가능한 도구

쉘 명령을 실행합니다

인수 목록을 사용하여 셸 명령을 안전하게 실행합니다.

execute_shell_command(["ls", "-la"]) execute_shell_command(["grep", "-r", "TODO", "./src"]) execute_shell_command(["python", "analysis.py", "--input", "data.csv"]) execute_shell_command(["uname", "-a"])

파일 표시

선택적 줄 범위 지정을 사용하여 파일 내용 보기:

show_file("/path/to/file.txt") show_file("/path/to/file.txt", num_lines=10) show_file("/path/to/file.txt", start_line=5, num_lines=10)

파일에서 검색

정규 표현식을 사용하여 파일에서 패턴을 검색합니다.

search_in_file("/path/to/script.py", r"def\s+\w+\s*\(") search_in_file("/path/to/code.py", r"#\s*TODO", case_sensitive=False)

편집_파일

파일을 정확하게 변경하세요:

# Replace text edit_file("config.json", replacements={"\"debug\": false": "\"debug\": true"}) # Insert at line 5 edit_file("script.py", line_operations=[{"operation": "insert", "line": 5, "content": "# New comment"}]) # Delete lines 10-15 edit_file("file.txt", line_operations=[{"operation": "delete", "start_line": 10, "end_line": 15}]) # Replace line 20 edit_file("file.txt", line_operations=[{"operation": "replace", "line": 20, "content": "Updated content"}])

쓰기_파일

파일에 내용을 쓰거나 추가합니다.

# Overwrite file write_file("/path/to/file.txt", "New content") # Append to file write_file("/path/to/log.txt", "Log entry", mode="a")

페치_페이지

웹 페이지의 내용을 PDF로 가져온 다음(크롬 설치 필요) 로컬 LLM을 사용하여 마크다운으로 구문 분석합니다.

fetch_page("https://example.com")

운송 메커니즘

MCP는 클라이언트와 서버 간 통신을 위한 다양한 전송 방법을 지원합니다.

표준 입출력(stdio) : 통신을 위해 표준 입출력을 사용하며 로컬 프로세스에 이상적입니다.
SSE(Server-Sent Events) : 클라이언트-서버 통신을 위한 HTTP POST 요청으로 서버-클라이언트 스트리밍을 활성화합니다.

이 구현에서는 텍스트 입출력을 통해 통신하는 로컬 MCP 서버를 사용합니다.

자신의 도구로 확장하기

@mcp.tool 데코레이터를 사용하여 새 도구를 추가하여 이 MCP 서버를 쉽게 확장할 수 있습니다. server.py의 패턴을 따라 LLM 클라이언트에 추가 기능을 제공하는 새 도구를 만드세요.

보안 고려 사항

MCP 서버는 Claude에게 로컬 시스템에 대한 접근 권한을 제공합니다. 다음 사항에 유의하세요.

서버는 사용자로 셸 명령을 실행합니다.
시스템의 파일을 읽고, 쓰고, 수정할 수 있습니다.
보안이 우려되는 경우 특정 디렉토리에 대한 액세스를 제한하는 것을 고려하세요.

Install Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Reddit Discussion

Related Servers

MCP Tools