MCP 모듈 설치
1. MCP 모듈 설치
C 드라이브 바로 아래에 test라는 폴더를 만들고, VSCode로 해당 폴더를 열어주세요. File > Open Folder를 클릭하여 test 폴더를 선택합니다. Ctrl + 백틱(1옆에 있는 특수기호)을 누르면 VSCode의 터미널이 열립니다. 아래와 같이 입력하여 mcp 모듈을 설치합니다.
여기서 중요한 점이 있습니다. 앞으로도 우리는 모듈을 설치할 텐데요. 클로드가 우리가 만든 함수를 실행시킬 때 함수에 사용하였던 모듈이 있다면 이 모듈이 우리 컴퓨터에 설치되어 있어야 합니다.
pip install mcppip install mcp이 mcp 모듈은 공식문서에서 연결되는 모듈입니다.
MCP 공식문서 mcp 모듈 링크2. 파이썬 코드 작성
이제 Claude가 사용할 수 있는 함수를 만들어보도록 하겠습니다. 아래와 같이 입력해주세요. Claude는 echo라는 함수를 이용할 수 있게 되는 것입니다. 함수 이름은 의도에 맞게 작성해주셔야 클로드가 이 함수를 '찾아낼 수' 있습니다.
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()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()3. 설정파일 작성
아까 열었던 claude_desktop_config.json 파일을 아래와 같이 수정해주세요.
{
"mcpServers": {
"tutorial_1": {
"command": "python",
"args": [
"C:\\test\\tutorial_1.py"
]
}
}
}{
"mcpServers": {
"tutorial_1": {
"command": "python",
"args": [
"C:\\test\\tutorial_1.py"
]
}
}
}여기서 command는 우리가 작성한 파이썬 파일을 실행하기 위한 명령어입니다. args는 해당 명령어에 들어가는 인자들입니다. 위의 예시에서는 python이라는 명령어에 C:\\test\\tutorial_1.py라는 인자를 넣어주었습니다. 이는 실제로 터미널에서 python 'C:\\test\\tutorial_1.py'를 입력하는 것과 같습니다.
파이썬 환경이 익숙하지 않으신 분은 test 폴더 안에 hello.py라는 파일을 만들고 print("hello world") 내용을 작성한 후 터미널을 열어 아래 명령어를 입력해보세요.
python hello.py
python 'C:\\test\\hello.py'python hello.py
python 'C:\\test\\hello.py'둘 다 동일한 결과를 출력합니다.
4. 공식 문서 예제
mcp 모듈 공식 페이지에 가면 아래와 같은 Quickstart 코드가 있습니다. 이걸로 먼저 시작해보셔도 좋습니다. 영상과 수업에서는 진행하지 않습니다.
# 공식 문서의 Quickstart, demo.py 예제
from mcp.server.fastmcp import FastMCP
# Create an MCP server
mcp = FastMCP("Demo")
# Add an addition tool
@mcp.tool()
def add(a: int, b: int) -> int:
"""Add two numbers"""
return a + b
if __name__ == "__main__":
mcp.run()# 공식 문서의 Quickstart, demo.py 예제
from mcp.server.fastmcp import FastMCP
# Create an MCP server
mcp = FastMCP("Demo")
# Add an addition tool
@mcp.tool()
def add(a: int, b: int) -> int:
"""Add two numbers"""
return a + b
if __name__ == "__main__":
mcp.run()claude_desktop_config.json 파일을 아래와 같이 수정해주세요.
{
"mcpServers": {
"demo": {
"command": "python",
"args": [
"C:\\test\\demo.py"
]
}
}
}{
"mcpServers": {
"demo": {
"command": "python",
"args": [
"C:\\test\\demo.py"
]
}
}
}FastMCP class에 대해 궁금하신 분들은 아래 링크로 찾아가시면 됩니다.
FastMCP class