MCP 베이스캠프 | 위니북스

MCP Inspector

1. MCP Inspector

MCP Inspector는 클로드로 내가 작성한 코드를 확인하지 않고 내가 작성한 코드가 제대로 작동하는지 확인할 수 있는 도구입니다.

파일명을 통해 서버에 접근할 수 있습니다. 지금은 server.py라는 이름으로 접근했습니다.
connect 버튼을 클릭하면 서버에 연결됩니다.
server.py에서 작성한 리소스, 프롬프트, 툴을 확인하고 테스트 할 수 있습니다.

2. 파일 작성

python sdk에 있는 예제를 그대로 사용하도록 하겠습니다. 다만 여기서 if __name__ == "__main__":코드가 없으면 서버가 실행되지 않으니 주의해주세요.

# server.py
from mcp.server.fastmcp import FastMCP
 
# Create an MCP server
mcp = FastMCP("Demo")
 
 
# Add an addition tool
@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b
 
 
# Add a dynamic greeting resource
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"
 
# 서버 실행
if __name__ == "__main__":
    mcp.run()

# server.py
from mcp.server.fastmcp import FastMCP
 
# Create an MCP server
mcp = FastMCP("Demo")
 
 
# Add an addition tool
@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b
 
 
# Add a dynamic greeting resource
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"
 
# 서버 실행
if __name__ == "__main__":
    mcp.run()

모듈을 설치해야 합니다. 아래 모듈을 설치해주세요. 혹시 uv가 설치되어 있지 않다면 함께 설치해주세요. uv는 pip처럼 패키지를 설치할 수 있는 툴입니다.

pip install mcp[cli]
pip install uv

pip install mcp[cli]
pip install uv

우리는 클로드에서 테스트해볼 것이 아니기 때문에 config.json을 수정할 필요는 없습니다. 제대로 설치가 되었다면 터미널에 mcp로 명령어를 입력해보세요. 아래와 같이 출력되었다면 제대로 실행된 것입니다.

3. dev

mcp dev 파일명.py로 실행하면 해당 파일과 함께 MCP Inspector가 실행됩니다. 아래와 같이 실행해보세요.

mcp dev server.py

mcp dev server.py

실행 URL은 http://localhost:5173/입니다.

Connect 버튼을 클릭하면 서버에 연결됩니다. 아래 초록색 버튼이 활성화되면 연결된 것입니다.
Tools 버튼을 클릭하면 툴을 확인할 수 있습니다. 아래 List Tools를 클릭하면 그 아래 함수명이 DocString과 함께 뜹니다.
함수명을 클릭하면 오른쪽에 입력할 수 있는 창과 실행시킬 수 있는 버튼이 뜹니다. 위와 같이 입력하면 30이 출력됩니다.

4. install

mcp install 명령어를 통해 claude_desktop_config.json에 직접 명령어를 추가할 수 있습니다.

mcp install server.py

mcp install server.py

{
  "mcpServers": {
    "mcp_project": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "C:\\test\\server.py"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp_project": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "C:\\test\\server.py"
      ]
    }
  }
}