포스트

[MCP] AI Agent에게 손과 발을 달아주는 법 (feat.korea-law-mcp)

[MCP] AI Agent에게 손과 발을 달아주는 법 (feat.korea-law-mcp)

MCP를 알고 사용해 본 지는 좀 됐지만, 활용처가 애매해서 많이 쓰지는 않았었다. 사무 업무가 많지 않은 나에겐 실질적으로 쓸만한 MCP가 몇 개 없었기 때문이다.

그러던 중, 최근 AI 덕분에 코딩의 경계가 허물어지며 비개발자도 개발 영역에 진입하게 되었고, 이로 인해 흥미로운 부가 서비스들이 많이 생겨났다.
korean-law-mcp는 한 공무원이 업무 중 법제처의 수많은 법률과 규칙을 직접 검색하는 것이 힘들어 개발한 법령 검색 MCP다. 특정 도메인 지식은 풍부하지만 비개발자인 사람이(과거라면 거의 불가능했겠지만) AI를 적극 활용해 본인에게 유용한 자동화 도구를 만든 아주 좋은 사례다.

어쨌든 이번 기회에 MCP의 기본 개념을 다시 학습하고, 로컬/원격 MCP를 사용하는 방법과 나만의 MCP 서버를 만드는 과정을 정리해보고자 한다.

MCP 아이콘

이미지만 봐도 뭔가 연결, 연동하는 느낌이 든다.

MCP


MCP(Model Context Protocol)는 한 마디로 AI 모델과 외부 데이터/도구를 연결하는 표준 규격이다. 앤트로픽에서 정의한, AI가 사용하는 외부 도구 공용 인터페이스 표준이라고 볼 수 있다.

통신 방식

통신 방식에는 2가지가 있다.

  • 로컬(Standard I/O)
  • 원격(HTTP/SSE)
구분로컬(stdio)원격 (HTTP/SSE)
개념로컬 프로세스 간 표준 입출력 통신웹 프로토콜 기반의 원격 통신
연결 방식stdin / stdout 파이프라인HTTP POST + Server-Sent Events
서버 위치사용자 로컬 컴퓨터 (Local)원격 서버 또는 클라우드 (Remote)
실행 주체AI 호스트 앱이 서버를 직접 실행별도의 독립된 서버 프로세스가 상시 구동
주요 장점보안성 우수, 설정 간편, 저지연(Low Latency)다수 유저 공유 가능, 클라우드 연동 용이
보안로컬 권한 내에서 격리됨네트워크 보안(CORS, 인증) 설정 필요
적합한 사례개인 파일 분석, 로컬 스크립트 실행팀 공용 DB 조회, 외부 API 서비스 통합

상세한 설명은 GPT에게 맡기고, 난 korean-law-mcp 를 활용한 온프레미스 및 외부 연동 실무 구현에 집중해보겠다.

로컬(Stdio) 방식

내 컴퓨터를 서버로 하여 사용하는 방식이다. 로컬로 하게 된다면 보통 CLI나, IDE에서 사용하게 될 것이다.

CLI에서 사용

우선 설치가 필요하다. 해당 mcp는 node 기반이기 때문에 npm으로 설치를 진행한다. 그 후, 법제처 Open API 인증키를 설정해준다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 설치
npm install -g korean-law-mcp

# 인증키 설정 (honggildong을 본인 키로 바꾸세요)
export LAW_OC=honggildong        # Mac/Linux
set LAW_OC=honggildong           # Windows CMD
$env:LAW_OC="honggildong"       # Windows PowerShell

# 사용 예시
korean-law "민법 제1조"                    # 자연어로 바로 조회
korean-law search_law --query "관세법"     # 도구 직접 호출
korean-law list                            # 전체 도구 목록
korean-law list --category 판례            # 카테고리별 필터
korean-law help search_law                 # 도구별 도움말

실제 사용 화면

사용 예시1 사용 예시2 사용 예시3

사용 방법은 아주 간단하다. 설치, 세팅 이후 바로 명령어로 사용하면 된다.

사용자 입장에서 간단하게 쓰라고 프로토콜을 정의했으니 당연하다.

다만 이 MCP의 실질적인 사용자는 비개발자가 대다수일텐데, CLI로 쓰긴 힘들 것 같긴 하다.

다른 프로그램에서 사용

VS Code에서 Cline으로 연결하여 사용했다. 위에서 로컬에 설치를 해놔서 내부 커맨드를 입력하면 된다.

ide-ex1

실제 사용 화면

ide-ex2


원격 방식

AI 서비스 웹이나, 앱에서 사용할 때 따로 설치 없이 사용하는 방법이다.

AI 웹 설정

web-1

대화 및 결과 출력

web-2 web-3

클로드 웹에서 간단하게 사용했다.

다음 목표

이제 MCP라는게 뭔지 실체는 잡혔다. 하지만 전공자라면 개념만 적당히 아는것은 크게 의미가 없고 실제로 어떻게 동작하는지 백앤드 요소까지 정확히 파악하고 있어야 한다고 생각한다. 다음장에서는 내부 동작 구조를 파헤쳐 볼 예정이다.

이 기사는 저작권자의 CC BY 4.0 라이센스를 따릅니다.