Skip to main content
Glama
Sign In
enesjakozh

MCP Tools

by ZbigniewTomanek
GitHub
Python
Apache 2.0
22
  • Apple
  • Linux
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Referenced as a related project through langchain-mcp-adapters, enabling the use of MCP tools with LangChain.

  • Referenced indirectly through MCP-Bridge which maps MCP tools to OpenAI's format, suggesting compatibility with OpenAI models.

  • Allows execution of Python scripts through the shell command tool, enabling AI agents to run Python code and analyze data.

MCP 도구

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

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

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

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

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를 지원하는 다른 클라이언트)

설치

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

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

지엑스피1

용법

Claude Desktop에서 연결

  1. 클로드 데스크톱 열기
  2. 식별자 "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에게 로컬 시스템에 대한 접근 권한을 제공합니다. 다음 사항에 유의하세요.

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

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

Claude Desktop과 다른 LLM이 표준화된 도구 인터페이스를 통해 파일 시스템 작업과 명령 실행 기능에 액세스할 수 있도록 하는 맞춤형 모델 컨텍스트 프로토콜 서버입니다.

  1. What is the Model Context Protocol?
    1. Key Benefits of MCP
      1. Features
        1. MCP Architecture
          1. Prerequisites
            1. Installation
              1. Usage
                1. Connecting from Claude Desktop
              2. Available Tools
                1. execute_shell_command
                2. show_file
                3. search_in_file
                4. edit_file
                5. write_file
                6. fetch_page
              3. Transport Mechanisms
                1. Extending with Your Own Tools
                  1. Related Projects
                    1. Security Considerations

                      Related Resources

                      Appeared in Searches

                      ID: fx1oclw99q