mcp-test

mcp-test

3.2

This document provides a guide to testing the interaction between a sample MCP Server and Claude Desktop (MCP Client).

mcp-test

Claude Desktop(MCP Client) μ΄μš©ν•΄ 예제 MCP Server κ°„ λ™μž‘ ν…ŒμŠ€νŠΈλ₯Ό ν•΄λ³΄μž

Skills

νŒ¨ν‚€μ§€ μ„€μΉ˜

  • requirements.txt에 μžˆλŠ” νŒ¨ν‚€μ§€ μ„€μΉ˜
pip install -r requirements.txt

μ˜ˆμ‹œ μΌ€μ΄μŠ€ μ½”λ“œ

case1/
└── rag/
    β”œβ”€β”€ __init__.py
    β”œβ”€β”€ base.py              ← RAG 검색 좔상화 클래슀
    β”œβ”€β”€ pdf.py               ← PDF νŠΉν™” RAG κ΅¬ν˜„
    β”œβ”€β”€ config.py            ← 경둜 및 μ„€μ • κ°’
    β”œβ”€β”€ auto_mcp_json.py     ← MCP 싀행을 μœ„ν•œ config JSON 생성기
    └── mcp_server.py        ← μ‹€μ œ MCP μ„œλ²„ μ§„μž…μ 

μ˜ˆμ‹œ μΌ€μ΄μŠ€ μ§„ν–‰ μ‹€ν–‰ μš”μ•½

  1. PDF 파일 /data/*.pdf 에 λ„£κΈ°
  2. .env에 OPENAI_API_KEY μ •μ˜
  3. python auto_mcp_json.py μ‹€ν–‰ β†’ mcp_config.json 생성
  4. MCP λŸ°νƒ€μž„μ—μ„œ rag-mcp μ‹€ν–‰
  5. MCP와 μ—°κ²°λœ ν΄λΌμ΄μ–ΈνŠΈκ°€ semantic_search("What is LangChain?") 쿼리 전솑
  6. 검색 κ²°κ³Ό λ§ˆν¬λ‹€μš΄ ν˜•νƒœλ‘œ 응닡

TODO

ν…ŒμŠ€νŠΈ κ²°κ³Ό

1μ°¨ κΈ°λ³Έ λ™μž‘ 확인 :: βœ…μ •μƒλ™μž‘

  • 데λͺ¨ MCP Serverλ₯Ό μž‘μ„±ν•΄ Fastmcp둜 μ„€μΉ˜ν•˜κ³ , ν΄λ‘œλ“œ μ•±μ—μ„œ λ™μž‘ 확인
❯ fastmcp install mcp_server.py
# Demo MCP server
[03/28/25 23:26:48] INFO     Added server 'Demo' to Claude config                                                                              claude.py:125
                    INFO     Successfully installed Demo in Claude app   
                                        
open -a Claude

2μ°¨ μ˜ˆμ‹œμΌ€μ΄μŠ€ 확인 :: βœ…μ •μƒλ™μž‘

# [1] MCP config 생성
python case1/auto_mcp_json.py

# [2] μƒμ„±λœ config.json을 ν΄λ‘œλ“œ λ°μŠ€ν¬νƒ‘ 섀정에 볡사

# [3] ν΄λ‘œλ“œ λ°μŠ€ν¬νƒ‘ μ‹€ν–‰
open -a Claude
2μ°¨ μ˜ˆμ‹œμΌ€μ΄μŠ€ ν΄λ‘œλ“œ λ°μŠ€ν¬νƒ‘ λ™μž‘ 캑쳐
1. μ—°κ²° 확인
image
2. 질문
image image