5분만에 커스텀 MCP 서버 구축하기

지난 포스팅에서는 MCP 사용 방법을 다뤘었다.
이번에는 MCP서버를 구축하는 방법을 알아보자.

windows os, python3.10버전 이상이 필요하다.

0. powershell을 실행한다. (주의: cmd 아님)
1. uv(pip보다 빠른 패키지 인스톨러)를 설치한다. (c드라이브에 설치가 이뤄진다.)

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. 새 폴더를 생성한다.

uv init buildMCP
cd buildMCP

3. 가상환경을 생성하고 활성화한다.

uv venv
.venv\Scripts\activate

파일 경로 전에 (buildMCP)라고 떠야 가상환경이 활성화 된 것이다.

4. 의존성을 설치한다.

uv add mcp[cli] httpx

5. my_mcp.py를 생성한다.

new-item my_mcp.py

5. my_mcp.py에서 필요한 모듈을 import하고 기본 값을 초기화한다.

from typing import Any
import httpx
from mcp.server.fastmcp import FastMCP

# Initialize FastMCP server
mcp = FastMCP("myMCP")

6. tool 2개를 정의한다.

@mcp.tool()
def hello(to):
	"""say hello to {to}."""
	return f"hello, {to}!"
    
def goodbye(to):
	"""print goodbye to {to}."""
	return f"goodbye, {to}"

8. main함수를 작성한다.

if __name__ == "__main__":
    # Initialize and run the server
    mcp.run(transport='stdio')

9. 부모경로/vscode/mcp.json파일에 다음과 같이 myMCP 서버를 추가한다.

{
    "mcpServers": {
        "myMCP": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\부모폴더\\buildMCP",
                "run",
                "my_mcp.py"
            ]
        }
    }
}

10. 시작 버튼을 눌러서 mcp서버를 실행하고 코파일럿을 agent모드로 변경한다.
11. #hello gpt한테 인사해줘. 를 입력하고 응답을 확인한다.