[Claude] Claude Desktop 로컬 MCP 서버 연결

728x90

이번 글에서는 Claude Desktop에 로컬 MCP 서버를 연결하는 방법에 대해 살펴보겠습니다.

우선 MCP에 대한 간략한 설명입니다. MCP는 Model Context Protocol의 약자로, LLM의 일부 한계를 보완하기 위해 2024년 11월 Anthropic에서 도입한 개방형 표준입니다. LLM은 1) 이미 학습된 모델이기에 실시간 데이터를 반영하기 힘들고, 2) 외부 애플리케이션과 상호작용할 수 없다는 한계가 있었습니다. 따라서 LLM이 다양한 데이터 소스 및 도구에 쉽게 연결되고 실시간으로 정보를 주고받을 수 있도록 설계된 것이 바로 MCP입니다.

1. 로컬 MCP 서버 연결 방법

로컬 MCP 서버를 연결하기 위해서는 먼저 로컬에 MCP 서버를 생성해야 합니다. 저는 Python의 FastMCP 패지키를 활용했습니다. 코드 예제는 다음과 같습니다. "calculation"이라는 MCP 서버이고 add라는 두 수를 더하는 tool이 내장되어 있습니다.

# sample.py
from mcp.server.fastmcp import FastMCP

mcp = FastMCP("calculation")

@mcp.tool()
def add(a: float, b: float) -> float:
    """두 개의 숫자를 입력받아 합을 반환합니다."""
    return a + b
    
if __name__ == "__main__":
    print("MCP 서버를 실행합니다.")
    mcp.run(transport='stdio')

이제 해당 MCP 서버를 Claude Desktop에 연결해보겠습니다. Claude Desktop의 좌측 하단을 보면 프로필이 있습니다. 프로필을 클릭하고 설정을 선택해 줍니다.

그럼 설정 창이 나타나게 되는데 이 중 '개발자' 탭으로 이동합니다. 개발자 탭은 로컬 MCP 서버를 추가하고 관리하는 곳입니다. MCP 서버 추가는 '구성 편집'을 클릭하면 됩니다.

구성 편집을 클릭하면, 폴더 창이 띄워지고 'claude_desktop_config.json'이라는 파일에 클릭 한 번이 되어있는 것을 확인할 수 있습니다. 해당 파일을 열면 아래와 같은 코드가 나타납니다.

{
  "mcpServers": {}
}

해당 코드에 추가하고자 하는 MCP 서버에 대한 정보를 입력하고 저장을 진행합니다.

{
  "mcpServers": {
    "calculation": {
      "command": "python3",
      "args": ["{file_dir}/sample.py"]
    }
  }
}

구성 편집을 진행하면 Claude Desktop에 바로 반영되지 않으므로, 이를 위해서는 Claude Desktop을 종료 후 재실행을 해야 합니다. 이때 좌측 상단 '햄버거 버튼 > 파일 > 종료'를 클릭하여 프로그램 자체를 아예 종료한 후 재실행해줘야 제대로 반영됩니다.