Gemini CLI ๐Ÿค FastMCP: MCP ์„œ๋ฒ„ ๊ฐœ๋ฐœ ๊ฐ„์†Œํ™”

2025๋…„ 9์›” 22์ผ
Jack Wotherspoon Developer Advocate
Jeremiah Lowin FastMCP Creator

MCP(Model Context Protocol) ์„œ๋ฒ„ ๊ฐœ๋ฐœ์„ ๊ฐ„์†Œํ™”ํ•  ์ค€๋น„๋ฅผ ํ•˜์„ธ์š”! Gemini CLI๋Š” ์ด์ œ MCP ์„œ๋ฒ„ ๊ฐœ๋ฐœ์„ ์œ„ํ•œ Python์˜ ์„ ๋„์ ์ธ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์ธ FastMCP์™€ ์›ํ™œํ•˜๊ฒŒ ํ†ตํ•ฉ๋ฉ๋‹ˆ๋‹ค. ๋‘ ์˜คํ”ˆ์†Œ์Šค ํ”„๋กœ์ ํŠธ๊ฐ„ ํ†ตํ•ฉ์„ ํ†ตํ•ด ์‚ฌ์šฉ์ž ์„ค์ • MCP ๋„๊ตฌ์™€ ํ”„๋กฌํ”„ํŠธ๋ฅผ Gemini CLI์— ์ง์ ‘ ์†์‰ฝ๊ฒŒ ์—ฐ๊ฒฐํ•  ์ˆ˜ ์žˆ์Œ์„ ๋ฐœํ‘œํ•˜๊ฒŒ ๋˜์–ด ๊ธฐ์ฉ๋‹ˆ๋‹ค!

Gemini CLI ๐Ÿค FastMCP

์ด์ œ FastMCP v2.12.3๋ถ€ํ„ฐ fastmcp install gemini-cli ๋ช…๋ น์„ ์‚ฌ์šฉํ•˜์—ฌ FastMCP๋กœ ๊ฐœ๋ฐœ๋œ ๋กœ์ปฌ STDIO ์ „์†ก MCP ์„œ๋ฒ„๋ฅผ ์„ค์น˜ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

fastmcp install gemini-cli server.py
Shell

์ด ๋ช…๋ น์€ ํ”„๋กœ์„ธ์Šค๋ฅผ ๊ฐ„์†Œํ™”ํ•˜๊ณ  FastMCP ์„œ๋ฒ„์˜ ๊ธฐ๋Šฅ์„ Gemini CLI ๋‚ด์—์„œ ์ฆ‰์‹œ ์‚ฌ์šฉ ๋ฐ ๊ตฌ์„ฑํ•  ์ˆ˜ ์žˆ๋„๋ก ํ•ฉ๋‹ˆ๋‹ค! ๊ตฌ์„ฑ๊ณผ ์ข…์†์„ฑ ๊ด€๋ฆฌ๋ฅผ ์ž๋™์œผ๋กœ ์ฒ˜๋ฆฌํ•˜๊ณ  Gemini CLI์˜ ๋‚ด์žฅ๋œ MCP ๊ด€๋ฆฌ ์‹œ์Šคํ…œ(gemini mcp add)์„ ํ˜ธ์ถœํ•ฉ๋‹ˆ๋‹ค. ๋กœ์ปฌ ์„œ๋ฒ„ ๊ฐœ๋ฐœ์—์„œ ์ด ํ†ตํ•ฉ์€ ํŽธ๋ฆฌํ•˜๊ฒŒ ์‹œ์ž‘ํ•  ์ˆ˜ ์žˆ๋Š” ๋ฐฉ๋ฒ•์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

Gemini CLI์˜ ์ž ์žฌ๋ ฅ ์ตœ๋Œ€ํ•œ ํ™œ์šฉ

MCP ์„œ๋ฒ„๋Š” ์—์ด์ „ํŠธ๊ฐ€ ๋‹ค๋ฅธ ๋ฐฉ๋ฒ•์œผ๋กœ๋Š” ์ˆ˜ํ–‰ํ•  ์ˆ˜ ์—†๋Š” ์ž‘์—…์„ ์ˆ˜ํ–‰ํ•˜๊ณ  ์ปจํ…์ŠคํŠธ์— ์•ก์„ธ์Šคํ•  ์ˆ˜ ์žˆ๋„๋ก ํ•˜์—ฌ Gemini CLI ๊ฒฝํ—˜์„ ํฌ๊ฒŒ ํ–ฅ์ƒ์‹œํ‚ฌ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. FastMCP์˜ Python ๋ฐฉ์‹ ๋””์ž์ธ์€ ๋ฐ์ฝ”๋ ˆ์ดํ„ฐ์™€ ํƒ€์ž… ํžŒํŠธ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๋‹ค์Œ ๊ตฌ์„ฑ์š”์†Œ๋ฅผ ๊ฐ„๋‹จํ•˜๊ณ  ์ง๊ด€์ ์œผ๋กœ ๋งŒ๋“ค ์ˆ˜ ์žˆ๋„๋ก ํ•ด์ค๋‹ˆ๋‹ค.

  • ๋„๊ตฌ: Gemini CLI๊ฐ€ ์ž‘์—…์ด๋‚˜ ๊ณ„์‚ฐ์„ ์ˆ˜ํ–‰ํ•˜๊ฑฐ๋‚˜ ์™ธ๋ถ€ API ๋ฐ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์™€ ์ƒํ˜ธ์ž‘์šฉํ•˜์—ฌ ์›Œํฌํ”Œ๋กœ์— ์ ๊ทน์ ์œผ๋กœ ์ฐธ์—ฌํ•  ์ˆ˜ ์žˆ๋„๋ก ํ•ฉ๋‹ˆ๋‹ค.
  • ํ”„๋กฌํ”„ํŠธ: FastMCP์—์„œ ์ •์˜ํ•œ ํ”„๋กฌํ”„ํŠธ๋ฅผ Gemini CLI ๋‚ด์—์„œ ์Šฌ๋ž˜์‹œ ๋ช…๋ น์–ด(์˜ˆ: /promptname)๋กœ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ์ด๋ฅผ ํ†ตํ•ด ์ƒํ˜ธ์ž‘์šฉ์ด ๊ฐ„์†Œํ™”๋˜๊ณ  ์ผ๋ฐ˜์ ์œผ๋กœ ์‚ฌ์šฉํ•˜๋Š” ํ”„๋กฌํ”„ํŠธ๊ฐ€ ํ„ฐ๋ฏธ๋„ ํ™˜๊ฒฝ์— ์ž์—ฐ์Šค๋Ÿฝ๊ฒŒ ๋…น์•„๋“ญ๋‹ˆ๋‹ค.

์ง€๊ธˆ ์‹œ์ž‘ํ•˜์„ธ์š”

์ด ํ†ตํ•ฉ์„ ์‚ฌ์šฉํ•ด ๋ณด๊ณ  ์‹ถ์œผ์„ธ์š”? Gemini CLI์™€ FastMCP๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ์‰ฝ๊ฒŒ ์‹œ์ž‘ํ•˜๊ณ  ์‹คํ–‰ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

  1. Gemini CLI๋ฅผ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค. npm install -g @google/gemini-cli@latest
  2. FastMCP(v2.12.3 ์ด์ƒ)๋ฅผ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค. pip install fastmcp>=2.12.3
  3. ์‚ฌ์šฉ์ž ์„ค์ • ๋„๊ตฌ์™€ ํ”„๋กฌํ”„ํŠธ๋กœ server.py๋ฅผ ๋งŒ๋“ญ๋‹ˆ๋‹ค. (์˜ˆ)
  4. ํ†ตํ•ฉ: fastmcp install gemini-cli server.py
  5. Gemini CLI๋ฅผ ์‹คํ–‰ํ•˜๊ณ  /mcp๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

์ž์„ธํ•œ ๋‚ด์šฉ๊ณผ ๊ณ ๊ธ‰ ๊ตฌ์„ฑ์€ ๊ณต์‹ FastMCP ํ†ตํ•ฉ ์„ค๋ช…์„œ๋ฅผ ์ฐธ์กฐํ•˜์„ธ์š”.

์—ฌ๋Ÿฌ๋ถ„์ด ์–ด๋–ค ํ˜์‹ ์ ์ธ MCP ์„œ๋ฒ„๋ฅผ ๊ฐœ๋ฐœํ•˜๊ณ  Gemini CLI์—์„œ ๊ทธ๊ฒƒ์„ ์–ด๋–ป๊ฒŒ ํ™œ์šฉํ•˜์‹ค์ง€ ๊ธฐ๋Œ€๋ฉ๋‹ˆ๋‹ค!

FastMCP ๋˜๋Š” Gemini CLI์—์„œ ๋ณด๊ณ  ์‹ถ์€ ๊ธฐ๋Šฅ ์š”์ฒญ์ด๋‚˜ ๊ฐœ์„  ์‚ฌํ•ญ์ด ์žˆ๋‚˜์š”? ๋‘˜ ๋‹ค ์˜คํ”ˆ์†Œ์Šค๋กœ ์ œ๊ณต๋˜๋ฏ€๋กœ GitHub์—์„œ ์ง์ ‘ FastMCP ๋˜๋Š” Gemini CLI๋ฅผ ํ†ตํ•ด ์ƒˆ๋กœ์šด ์ด์Šˆ๋ฅผ ์—ด์–ด ์˜๊ฒฌ์„ ์ „๋‹ฌํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.