๐ Python SDK์ UV๋ก MCP ์๋ฒ ๋ง๋ค๊ธฐ ์ค์ต๊ธฐ: ๋ํ vs ํธ๋๋ผ๋ ์ค์ ์ ํฌ๊น์ง โ๏ธ
2025.05.26

๐ Python SDK์ UV๋ก MCP ์๋ฒ ๋ง๋ค๊ธฐ ์ค์ต๊ธฐ: ๋ํ vs ํธ๋๋ผ๋ ์ค์ ์ ํฌ๊น์ง โ๏ธ
์๊ฐ
ํ ์์ผ ์ค์ต์ผ๋ก Python SDK๋ฅผ ์ด์ฉํด MCP ์๋ฒ ๊ฐ๋ฐ์ ์ง์ ๋ฐ๋ผ ํด๋ดค์ด์. ์ต๊ทผ Python ์ํ๊ณ์์ ํ์ ๊ฐ ๋๊ณ ์๋ ๋น ๋ฅธ ํ๋ก์ ํธ ๋งค๋์ uv๋ฅผ ํ์ฉํด ํ๊ฒฝ ๊ตฌ์ฑ๋ ํด๋ดค๊ณ ์. ์ค์ต์ ๋จ์ํ ์ฝ๋ ๋ฐ๋ผํ๊ธฐ๊ฐ ์๋๋ผ, LLM์ด ๋ง๋ ๊ฐ์์ ์บ๋ฆญํฐ ๋ฐ์ดํฐ๋ฅผ MCP ์๋ฒ์ ์ฐ๊ฒฐํด ์ค์ ํด์ฒ๋ผ ์๋์ํค๋ ๊ฒฝํ๊น์ง ์ด์ด์ก์ต๋๋ค ๐
๊ทธ๋ฆฌ๊ณ ๋ง์ง๋ง์ Claude Desktop์์ ์บ๋ฆญํฐ ์ ํฌ๋ฅผ ์๋ฎฌ๋ ์ด์ ํ๋๋ฐโฆ ์ ๊ฐ ๋ง๋ ์บ๋ฆญํฐ ๋ํ ๊ฐ ํธ๋๋ผ๋ ์ค๋ฅผ ์ด๊ฒผ์ต๋๋ค! ๐
์งํ ๋ฐฉ๋ฒ
๐งฐ 1. UV ์ค์น ๋ฐ ํ๊ฒฝ ๊ตฌ์ฑ
uv๋?
Rust ๊ธฐ๋ฐ ์ด๊ณ ์ Python ํ๋ก์ ํธ ๋งค๋์
ruff๋ฅผ ๋ง๋ Astral์์ ๊ฐ๋ฐํ ๋๊ตฌ๋ก, venv + ํจํค์ง ๊ด๋ฆฌ + ์คํ๊น์ง ์ง์ํฉ๋๋ค ๐จ
๐ป ์ค์น ๋ฐฉ๋ฒ
macOS (Homebrew)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install uv
Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
โ๏ธ ํ๋ก์ ํธ ์์ฑ
uv init my-mcp-server
cd my-mcp-server
uv venv
๊ฐ์ํ๊ฒฝ ํ์ฑํ:
macOS:
source .venv/bin/activateWindows:
.venv\Scripts\activate
๐ฆ ํ์ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์ค์น
uv add fastmcp
๐ ๏ธ 2. Windsurf๋ก ํ๋ก์ ํธ ๊ฐ๋ฐํ๊ธฐ
Windsurf ์คํ ํ
File > Open Folder์ ํํฐ๋ฏธ๋ ์ด๊ณ ๊ฐ์ํ๊ฒฝ ํ์ฑํ
๐งช 3. MCP ์๋ฒ ๊ธฐ๋ณธ ๊ธฐ๋ฅ ๊ตฌํ
main.py ํ์ผ ์์ฑ:
from fastmcp import FastMCP
mcp = FastMCP("My MCP Server")
@mcp.tool()
def echo_tool(message: str) -> str:
return f"Tool echo: {message}"
if __name__ == "__main__":
mcp.run(transport='stdio')
โ ํ ์คํธ
fastmcp dev main.py
์น ๋ธ๋ผ์ฐ์ ์์
http://127.0.0.1:6274์ ์ โ STDIO ์ฐ๊ฒฐ โecho_toolํ ์คํธ
๐ง 4. ์บ๋ฆญํฐ ๋ฐ์ดํฐ ์ฐ๋ ๋ฐ ํด ์ถ๊ฐ
๐ ๋ฐ์ดํฐ ํด๋ ๋ฐ CSV ์์ฑ
data/char_info.csv์์ฑ (๋ด์ฉ์ Claude์๊ฒ ์์ฑ ์์ฒญ)์์:
name,information
๋ํ ,"์ฐจ๊ฐ์ด ๋๋ณด๋ผ๋ฅผ ๋ค๋ฃจ๋ ๋ง๋ฒ์ฌ"
ํธ๋๋ผ๋ ์ค,"๋
ธ๋๋ก ์ ์ ๋ฌด์ฅํด์ ์ํค๋ ์ ์ฌ"
๐งฌ ํด ํจ์ ์ถ๊ฐ
import csv, os
data_path = os.path.join(os.path.dirname(__file__), 'data', 'char_info.csv')
@mcp.tool()
def get_character_info(name: str) -> str:
with open(data_path, newline='', encoding='utf-8') as f:
reader = csv.DictReader(f)
for row in reader:
if row['name'] == name:
return row['information']
return "์บ๋ฆญํฐ ์ ๋ณด๋ฅผ ์ฐพ์ ์ ์์ต๋๋ค."๐ ์๋๊ฒฝ๋ก ์ฒ๋ฆฌ ์ด์
MCP Host์์ ์คํ ์ ์ ๋๊ฒฝ๋ก ์ฌ์ฉ ์ ์๋ฌ ๋ฐ์
โ Python ํ์ผ ๊ธฐ์ค ์๋๊ฒฝ๋ก๋ก ์์
๐ฅ๏ธ 5. Claude Desktop ์ฐ๋
MCP ์ค์น ๋ฐ ์คํ
fastmcp install main.pyClaude Desktop ์ฌ์คํ ํ ํด ์ธ์

๐งช ํ ์คํธ ์์
echo_tool:
์๋ ํ์ธ์ โ "Tool echo: ์๋ ํ์ธ์"
get_character_info:
"๋ํ ", "ํธ๋๋ผ๋ ์ค" โ ๋ ์บ๋ฆญํฐ ์๊ฐ + ์ ํฌ ์๋ฎฌ๋ ์ด์
์น์๋โฆ ๋ํ ! ๐งโ๏ธ๐ฅ
์น๋ถ์์ธก
dong-to๋ ํธ๋๋ผ๋ ์ค๋ ์ธ์ฐ๋ฉด ๋๊ฐ ์ด๊ฒจ?


๊ฒฐ๊ณผ์ ๋ฐฐ์ด ์
๐ ์ข์๋ ์
uv ๋๋ถ์ ํ๊ฒฝ ์ค์ ์ด ๋งค์ฐ ๋น ๋ฅด๊ณ ๊ฐํธํ์
MCP SDK๊ฐ ๊ตฌ์กฐ์ ์ผ๋ก ์ ์ง์ฌ ์์ด ํ์ฅํ๊ธฐ ์ฌ์
Claude Desktop์์ ์ง์ ํด ํ ์คํธ๊น์ง ๊ฐ๋ฅํด ๊ฐ๋ฐ ๋ชฐ์ ๋๊ฐ ๋์์
๐ตโ๐ซ ์ด๋ ค์ ๋ ์
CSV ์๋๊ฒฝ๋ก ์ค์ ์์ ์ฝ์ง (ํ์ง๋ง ๋๋ถ์ Python ๊ฒฝ๋ก ๋ค๋ฃจ๋ ๋ฒ ์์ง!)
LLM์ด ์์ฑํ ๋ฐ์ดํฐ๊ฐ ์๋ชป๋ ๊ฒฝ์ฐ ํด ๊ฒฐ๊ณผ์ ์ํฅ โ ๋ฐ์ดํฐ ์ ๋ขฐ๋ ์ฃผ์ ํ์
๊ฐ์ํ๊ฒฝ ๊ตฌ์ถ ๊ฒฝ๋ก๋ฅผ ์ ๋ง์ถ ํ์๊ฐ ์์
๐ง ๋๋ ์
"์ค์ต์ด์์ง๋ง ์ง์ง ๋ด ํด์ ๋ง๋ ๊ธฐ๋ถ".
๋จ์ํ ๋ฐ๋ผ ํ๋ ๊ฒ์ด ์๋๋ผ, ๋ด๊ฐ ์ง์ ๋ง๋ ๋ฐ์ดํฐ๋ฅผ ๋ฐํ์ผ๋ก ์๋ฒ๋ฅผ ๋์ฐ๊ณ ํด๋ก ๋ถ๋ฌ์ ์๋ฎฌ๋ ์ด์
๊น์ง ์งํํ๋ฉด์ ๊ฐ๋ฐ์ ๊ฐ์ฑ ์ ๋๋ก ์ถฉ์ ๋์ต๋๋ค.
SDK + UV + Claude ์กฐํฉ์ ์ถ์ฒํ๊ณ ์ถ์ด์! ๐ฅ
๋์ ๋ฐ์ ๊ธ
Claude ๊ด๋ จ ์์ ํ๋กฌํํธ ๋ฐ ์ค์ต ์๋ฃ
ํจ๊ป ์ด์ผ๊ธฐํด์ 4
๋ก๊ทธ์ธํ๊ณ ๋๊ธ์ ๋จ๊ฒจ ์ฃผ์ธ์
์ด ๊ณ ํต์ ์ฌ์ ์ ๋๊น์ง ํจ๊ป ํด์ฃผ์๊ณ ๋์๊ฐ ๋ํ ์บ๋ฆญํฐ๊น์ง ๋ น์ฌ ์ฃผ์ ์ ์ง์ฌ ๊ฐ์ฌ๋๋ฆฝ๋๋ค.
๋ฆฌ๋ฉํ์๋๋ผ ๋๋ฌด ๊ณ ์๋ง์ผ์ จ์ต๋๋ค ใ ใ ๋ ์ฌ๋ฐ์์ด์ ใ ใ ใ




์ ์ด์ 9๋ฏธ๋ฅผ๋ฅด๋ฅผ๋ฅผ๋ฅด ์ค์ ์ ํจ๊ป ์งํํ์์ฃ !ใ ใ ใ
๊ตฌ๋ฏธ๋ฅผ๋ฅผ๋ฅผ๋ฅด๋ฅด๋ฅด...๋ ๋ํ ์ ๋๋ฃ๊ฐ ๋์ด๋ผ!