우분투에서 mcp 사용하기

Apic·2025년 4월 8일

코딩

목록 보기

17/24

mcp가 핫하다길래 사용해 보려고 한다.

https://github.com/aaddrick/claude-desktop-debian

여기에 들어가서 설치 방법을 따라해준다.

# Clone this repository
git clone https://github.com/aaddrick/claude-desktop-debian.git
cd claude-desktop-debian

# Build the package (Defaults to .deb and cleans build files)
./build.sh

# Example: Build an AppImage and keep intermediate files
./build.sh --build appimage --clean no

# Example: Build a .deb (explicitly) and clean intermediate files (default)
./build.sh --build deb --clean yes

# Replace VERSION and ARCHITECTURE with the actual values from the filename
sudo dpkg -i ./claude-desktop_VERSION_ARCHITECTURE.deb 

# If you encounter dependency issues, run:
sudo apt --fix-broken install

설치를 하면

이렇게 앱이 생긴다.

이제 코드를 작성해준다.

프로그램을 실행하고 왼쪽 상단의 메뉴 - 설정으로 들어간다.

그리고 개발자 탭으로 가면 이렇게 뜨는데 여기서 설정 편집을 눌러준다.

그러면 이렇게 폴더 창이 하나 뜨는데 여기서 claude_desktop_config.json 파일을 수정해준다.

해당 파일을 vsocde에서 보면

이렇게 빈 공간으로 나올텐데

{
    "mcpServers": {
        "tutorial_1": {
            "command": "python",
            "args": [
                "/home/apic/python/temp/mcp_temp.py"
            ]
        }
    }
}

이런식으로 적으면 된다.

여기서 tutorial_1은 나중에 파이썬 코드에서 적을 이름이고,
command는 python의 위치.
args는 내가 적은 파이썬 코드 위치다.

이제 파이썬 코드를 적어준다.

파이썬 코드를 적을 위치는 위에 args에 적은 경로에 만들면 된다.


from mcp.server.fastmcp import FastMCP

# MCP 서버 생성
mcp = FastMCP(name="tutorial_1", host="127.0.0.1", port=5000, timeout=30)


# 간단한 에코 도구
@mcp.tool()
def echo(message: str) -> str:
    return message + " 라는 메시지가 입력되었습니다. 안찍어 볼 수 없죠! hello world!"


# 서버 실행
if __name__ == "__main__":
    mcp.run()

이렇게 적으면 된다.
FastMcp(name=[이름]) 여기다가 json 파일에서 적은 이름을 똑같게 적으면 된다.
만약 FastMcp(name="demo", host="127.0.0.1", port=5000, timeout=30) 이런식으로 적었다면, json 파일에는

{
    "mcpServers": {
        "demo": {
            "command": "python",
            "args": [
                "/home/apic/python/temp/mcp_temp.py"
            ]
        }
    }
}

이렇게 turorial_1 대신에 demo를 넣으면 된다.

이 상태에서 claude를 껏다가 다시 실행하면