MCP 서버 10분 완성! 개념부터 Hello World까지 초보자도 따라하는 실전 가이드 🚀

MCP 서버를 직접 만드는 이유

지난 시간에 스미더리에서 다른 사람이 올린 MCP 서버를 내려받아 쓰는 법을 배웠어요. 그런데 기업에서는 내부 데이터나 기밀 정보를 다루기 때문에, 공개된 서버를 그대로 쓰기엔 부담이 커요.

그래서 직접 MCP 서버를 만드는 거예요. 내가 원하는 기능을 파이썬 함수로 만들어 넣고, LLM이 필요할 때만 불러서 쓰는 방식이죠. 쉽게 말하면 ‘붕어빵 틀’을 직접 만드는 것과 같아요. 매번 반죽을 손으로 빚지 않고, 틀에 넣기만 하면 똑같은 모양이 나오는 거예요.

FastMCP라는 프레임워크를 쓰면 이 틀을 정말 쉽게 만들 수 있어요. 엔스로픽에서 만든 도구라 MCP 서버를 빠르게 구성할 수 있답니다.

FastMCP로 Hello World 서버 만들기

먼저 터미널에서 pip install fastmcp를 입력해 설치해 주세요. 설치가 끝나면 Visual Studio Code를 열고 새 파일을 만들어 helloworld.py라고 저장하세요.

코드의 가장 위에 from fastmcp import FastMCP를 적고, 아래처럼 MCP 인스턴스를 만들어 줍니다. 이름은 helloworld로 지정했어요.

```python from fastmcp import FastMCP

mcp = FastMCP("helloworld")

@mcp.tool() def echo(message: str) -> str: """입력받은 메시지를 그대로 반환하는 도구""" return f"테스트 완료 메시지: {message}" ```

여기서 가장 중요한 게 바로 독스트링이에요. LLM이 이 함수가 무슨 일을 하는지 이해하려면 독스트링을 명확하게 써야 해요. 위 코드처럼 ‘입력받은 메시지를 그대로 반환하는 도구’라고 적어 두면 Claude가 이 도구를 정확히 찾아서 불러올 수 있어요.

마지막으로 파일 제일 아래에 실행 부분을 추가합니다.

python if __name__ == "__main__": mcp.run()

이렇게 저장하면 Hello World MCP 서버 준비가 끝났어요.

Claude Desktop에 연결하고 테스트하기

Claude Desktop을 열고 설정 → 커넥터 관리로 들어가세요. 여기서 ‘구성 편집’을 클릭하면 claude_desktop_config.json 파일이 열립니다.

아래처럼 새 MCP 서버 정보를 추가해 주세요.

json { "mcpServers": { "helloworld": { "command": "python", "args": ["C:/경로/helloworld.py"] } } }

경로는 여러분이 저장한 helloworld.py 파일 위치로 바꿔 주세요. 저장 후 Claude Desktop을 다시 시작하거나 ‘MCP 구성 새로 고침’을 누르면 helloworld 커넥터가 나타납니다.

이제 채팅창에 “helloworld 도구를 사용해서 ‘안녕 MCP’라고 출력해 줘”라고 입력해 보세요. Claude가 MCP 서버를 호출한 뒤, 여러분이 만든 echo 함수를 실행해서 결과를 보여줄 거예요.

이렇게 한 번 만들어 두면 앞으로 원하는 기능을 계속 추가하면서 쓸 수 있어요.