바이브코딩 윈드서프 + FastMCP로 로컬 MCP 서버 띄우기: 환경 이슈 뚫고 성공한 후기!

소개

16기 CTO & 스타트업실험실 2주차 오프라인 모임
2번째 세션 댕댕이멍멍님의 MCP 서버개발에 참석하였습니다.
FastMCP라는 프레임워크를 활용해 로컬에서 MCP 서버를 직접 띄워보고자 했습니다.
이 과정에서 Windsurf와 Python 환경을 활용해 실습을 진행했는데요,
서버 구조를 이해하고, 실제 툴을 만들어보며
AI 서버를 조금 더 가까이에서 체험해보았습니다.

진행 방법

사용한 도구

Windsurf
Python
UV (Python 패키지 매니저)
FastMCP 라이브러리

과정 요약

Python 설치 및 UV 설치

brew install uv

(⚠️ 하지만 여기서 문제가 발생했어요. 아래 에피소드 참고!)

Python 가상환경 구성 및 필수 라이브러리 설치

uv venv
source .venv/bin/activate
uv add fastmcp

main.py 코드 작성

from fastmcp import FastMCP

mcp = FastMCP("My MCP Server")

@mcp.tool()
def echo_tool(message: str) -> str:
    """Echo a message as a tool"""
    return f"Tool echo: {message}"

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

겪었던 시행착오

brew install uv 명령어가 제대로 작동하지 않아 한참을 붙잡고 있었습니다.
PowerShell에서 권한 에러 발생 → 관리자 권한 설정 및 권한 정책 수정
Python을 완전히 삭제 후 재설치
실시간 감시 기능(v3)이 실행 중이라 충돌 발생 → 해당 기능 종료 후 정상 작동

로컬서버에서 fastmcp 실행된 화면

결과와 배운 점

결국 FastMCP 서버를 로컬에서 성공적으로 띄우는 데 성공했어요 🎉
환경 설정 이슈는 사소해 보여도 굉장히 시간을 잡아먹을 수 있다는 걸 절감했습니다.
나와 다른 환경을 쓰는 사용자도 많기 때문에, 문제 해결 과정을 자세히 남기는 것이 앞으로 큰 도움이 될 것 같아요.

도움 받은 글 (옵션)

친절하게 Windsurf와 MCP 설치 가이드를 PDF로 정리해주신 댕댕이멍멍님 정말 감사합니다 🙏

완벽하지 않아도 시작해보면 재미있어요! 환경 이슈로 막히더라도 하나씩 해결해가는 경험이 쌓이면, 결국 더 빠르게 성장하게 된답니다 💪

⏰ AI스터디 17기 사전 모집 START (7월 시작 예정) | 빠르게 합류하세요 🚀