โ ๋ฉ์ธ์ผ๋ก ๋์๊ฐ๊ธฐ
1. MCP ๊ฐ์
MCP ๊ฐ์: Model Context Protocol - AI์ ์ธ๋ถ ์์คํ
๊ฐ ํ์คํ๋ ํต์ ํ๋กํ ์ฝ
โ
MCP ์ค์ 1๋จ๊ณ ์๋ฃ!
์์ ํ ๋ด์ฉ:
- ํ์ผ์์คํ
MCP ์๋ฒ ์ถ๊ฐ: ~/.aws/amazonq/mcp-config.json์ filesystem ์๋ฒ ์ค์ ์ถ๊ฐ
- MCP ํจํค์ง ์ค์น: @modelcontextprotocol/server-filesystem ๊ธ๋ก๋ฒ ์ค์น ์๋ฃ
ํ์ฌ MCP ์ค์ :
- filesystem: ๋ก์ปฌ ํ์ผ ์ ๊ทผ์ฉ (์๋ก ์ถ๊ฐ)
- datadog: ๋ชจ๋ํฐ๋ง ๋ฐ์ดํฐ์ฉ (๊ธฐ์กด)
๐จ ๋ฐ๊ฒฌ๋ ๋ฌธ์ - ํ๋ก์ธ์ค ์ค๋ณต ์คํ
2025-09-30 15:24 ์
๋ฐ์ดํธ
์ฌ๋ฌ Q CLI ํ๋ก์ธ์ค๊ฐ ๋์ ์คํ๋๋ฉด์ MCP ์ฐ๊ฒฐ ์ถฉ๋ ๋ฐ์ ์ค:
q chat ํ๋ก์ธ์ค 2๊ฐ
qchat ํ๋ก์ธ์ค 2๊ฐ
q_desktop ํ๋ก์ธ์ค 1๊ฐ
ํด๊ฒฐ ๋ฐฉ๋ฒ: ๋ชจ๋ Q ํ๋ก์ธ์ค ์ข
๋ฃ ํ ํด๋ฆฐ ์ฌ์์ ํ์
๐ฏ ๋ค์ ์ธ์
์ก์
ํ๋
1๋จ๊ณ: ํ๋ก์ธ์ค ์ ๋ฆฌ
pkill -f "q chat"
pkill -f "qchat"
pkill -f "q_desktop"
2๋จ๊ณ: ํด๋ฆฐ ์ฌ์์ ํ MCP ํ
์คํธ
- Q Chat ์ข
๋ฃ (
/quit)
- Q Chat ์ฌ์์ (
q chat)
/mcp ๋ช
๋ น์ด๋ก MCP ์๋ฒ ์ํ ํ์ธ
๐ง MCP๋?
์ ์: AI ๋ชจ๋ธ์ด ์ธ๋ถ ์์คํ
๊ณผ ํ์คํ๋ ๋ฐฉ์์ผ๋ก ํต์ ํ ์ ์๊ฒ ํด์ฃผ๋ ์คํ ํ๋กํ ์ฝ
ํ๋กํ ์ฝ: JSON-RPC 2.0 ๊ธฐ๋ฐ
๋ฒ์ : 2024-11-05 (์ต์ )
๐ฏ MCP์ ์ฅ์
- ํ์คํ: ์
๊ณ ํ์ค ํ๋กํ ์ฝ ์ฌ์ฉ
- ํ์ฅ์ฑ: ๋ค์ํ MCP ์๋ฒ ์ถ๊ฐ ๊ฐ๋ฅ
- ๋ณด์์ฑ: ์ ํ๋ ๊ฒฝ๋ก๋ง ์ ๊ทผ ํ์ฉ
- ํธํ์ฑ: ๋ค์ํ AI ๋๊ตฌ์ ์ฐ๋ ๊ฐ๋ฅ
2. ํ๊ฒฝ ๊ตฌ์ฑ
ํ๊ฒฝ ๊ตฌ์ฑ: MCP ์๋ฒ ์ค์ ๋ถํฐ Q CLI ์ฐ๋๊น์ง
๐ MCP ์ค์ ํ์ผ
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem",
"/Users/emart/Documents/PromptLibrary/edu"]
}
}
}
โ ๏ธ ์ค์ต ๊ฒฐ๊ณผ: Q CLI ํตํฉ์ ๋ฏธ์๋ฃ๋์์ผ๋, MCP ์๋ฒ ์์ฒด๋ ์์ ํ ๋์ํจ์ ํ์ธ
3. ๊ธฐ๋ฅ ํ
์คํธ
๊ธฐ๋ฅ ํ
์คํธ: MCP ์๋ฒ ์ง์ ์คํ์ ํตํ 13๊ฐ ๋๊ตฌ ๊ฒ์ฆ
๐ MCP ์๋ฒ ์ง์ ์คํ
npx -y @modelcontextprotocol/server-filesystem /Users/emart/Documents/PromptLibrary/edu
โ
์๋ฒ ์๋ต ์ฑ๊ณต
{
"result": {
"protocolVersion": "2024-11-05",
"capabilities": {"tools": {}},
"serverInfo": {
"name": "secure-filesystem-server",
"version": "0.2.0"
}
}
}
๐ง ์ฌ์ฉ ๊ฐ๋ฅํ MCP ๋๊ตฌ๋ค
- read_text_file - ํ
์คํธ ํ์ผ ์ฝ๊ธฐ (head/tail ์ง์)
- read_media_file - ์ด๋ฏธ์ง/์ค๋์ค ํ์ผ ์ฝ๊ธฐ (base64)
- write_file - ํ์ผ ์์ฑ/๋ฎ์ด์ฐ๊ธฐ
- edit_file - ๋ผ์ธ ๊ธฐ๋ฐ ํ์ผ ํธ์ง (git diff ์คํ์ผ)
- create_directory - ๋๋ ํ ๋ฆฌ ์์ฑ
- list_directory - ๋๋ ํ ๋ฆฌ ๋ชฉ๋ก ์กฐํ
- directory_tree - ์ฌ๊ท์ ํธ๋ฆฌ ๊ตฌ์กฐ ์กฐํ
- search_files - ํจํด ๊ธฐ๋ฐ ํ์ผ ๊ฒ์
- ์ด 13๊ฐ ๋๊ตฌ ํ์ธ
4. ๊ธฐ์กด ๋๊ตฌ ๋น๊ต
๊ธฐ์กด ๋๊ตฌ ๋น๊ต: MCP vs ๊ธฐ์กด Q CLI ๋๊ตฌ์ ์ค์ ์ฑ๋ฅ ๋น๊ต
๐ ๋น๊ต ๋ถ์ ๊ฒฐ๊ณผ
| ๊ตฌ๋ถ |
MCP ๋ฐฉ์ |
๊ธฐ์กด ๋๊ตฌ |
์ค์ต ๊ฒฐ๊ณผ |
| ํ๋กํ ์ฝ |
JSON-RPC 2.0 |
์ง์ ํจ์ ํธ์ถ |
โ
MCP ์ฑ๊ณต |
| ํ์คํ |
โ
์
๊ณ ํ์ค |
โ Q CLI ์ ์ฉ |
โ
ํ์ค ์ค์ |
| ํ์ฅ์ฑ |
โ
์๋ฒ ์ถ๊ฐ ๊ฐ๋ฅ |
โ ๋ด์ฅ ๋๊ตฌ๋ง |
โ
ํ์ฅ ๊ฐ๋ฅ |
5. ์ค์ต ๊ฒฐ๊ณผ
์ค์ต ๊ฒฐ๊ณผ: MCP๋ฅผ ํตํ ์์ ํ ์น ์ปจํ
์ธ ์์ฑ ๋ฐ AWS S3 ํผ๋ธ๋ฆฌ์ฑ ์ฑ๊ณต
๐ฏ ์ฃผ์ ์ฑ๊ณผ
โ
MCP ์๋ฒ ๋์ ํ์ธ: JSON-RPC 2.0 ํ๋กํ ์ฝ ํต์ ์ฑ๊ณต
โ
13๊ฐ MCP ๋๊ตฌ ์กฐํ: ๋ชจ๋ ํ์ผ์์คํ
๋๊ตฌ ์ฌ์ฉ ๊ฐ๋ฅ
โ
์น ์ปจํ
์ธ ์์ฑ: MCP๋ฅผ ํตํ HTML ํ์ผ ์์ฑ
โ
AWS S3 ํผ๋ธ๋ฆฌ์ฑ: MCP + AWS CLI ์ฐ๋ ์ฑ๊ณต
โ ๏ธ ํด๊ฒฐ ํ์ ์ฌํญ
Q CLI ํตํฉ ์ด์: `/mcp` ๋ช
๋ น์ด๊ฐ ์๋ฒ๋ฅผ ์ธ์ํ์ง ๋ชปํจ
์์ธ ์ถ์ : Q CLI ๋ฒ์ ํธํ์ฑ ๋ฌธ์
๋์: MCP ์๋ฒ ์ง์ ์คํ์ผ๋ก ๋ชจ๋ ๊ธฐ๋ฅ ํ์ฉ ๊ฐ๋ฅ
๐ ๊ต์ก์ ๊ฐ์น
- ์ค์ ๊ธฐ์ ํ
์คํธ: ์ด๋ก ์ด ์๋ ์ค์ ๋์ ํ์ธ
- ๋ฌธ์ ํด๊ฒฐ ๊ณผ์ : ํตํฉ ์คํจ ์ ๋์ ๋ฐฉ๋ฒ ๋ชจ์
- ๋น๊ต ๋ถ์: ๊ธฐ์กด ๋๊ตฌ์์ ์ฅ๋จ์ ์ค์ฆ
- ํฅํ ๋ฐ์ ๋ฐฉํฅ: MCP ๊ธฐ์ ์ ์ ์ฌ๋ ฅ ํ์ธ