MCP(Model Context Protocol)를 통한 도구
앱에 도구가 하나보다 많아지면, 모델 공급사마다 도구를 부르는 자기만의 JSON 모양을 발명하고, 제공자마다 어댑터를 쓰게 돼요. Model Context Protocol(MCP)이 이걸 고치는 열린 표준이에요. 도구(모델이 부를 수 있는 함수), 리소스(읽을 수 있는 데이터), 프롬프트를 어떤 모델 클라이언트에든 드러내는 JSON-RPC 2.0 통신 프로토콜이에요. MCP 서버를 한 번 쓰면, MCP를 아는 어떤 클라이언트(IDE 도우미, 데스크톱 앱, 에이전트)든 그것을 쓸 수 있어요.
모든 메시지는 작고 고정된 봉투인 JSON-RPC 2.0이에요. 요청은 언제나 키 네 개를 실어요:
{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": {"name": "add", "arguments": {"a": 2, "b": 3}}}id는 응답을 그 요청에 묶어요. 서버는 같은 id를 되울리고 result 또는 error 객체 중 하나를 싣는 응답으로 답하고, 둘 다 싣지는 않아요:
{"jsonrpc": "2.0", "id": 1, "result": {"content": [{"type": "text", "text": "5"}], "isError": false}}
{"jsonrpc": "2.0", "id": 1, "error": {"code": -32601, "message": "Method not found"}}음수 코드는 표준 JSON-RPC예요: -32601은 "method not found", -32602는 "invalid params" 등이에요. tools/call 결과는 언제나 그 모양이에요: 블록(글, 이미지 등)의 content 리스트와 isError. 실행됐지만 실패한 도구(예를 들어 잘못된 도시 이름)는 보통 결과 안에서 isError: true로 답해서 모델이 실패를 읽을 수 있게 해요. JSON-RPC error 객체는 모르는 메서드 같은 프로토콜 문제를 위한 거예요.
세션은 악수로 시작해요: 클라이언트가 initialize 요청(프로토콜 버전, 능력, 이름)을 보내고, 서버가 자기 능력으로 답하고, 클라이언트가 notifications/initialized 알림(아무도 답하지 않으니 id가 없는 메시지)으로 확인해요. 그다음에야 클라이언트가 빈 params로 tools/list를 불러 도구를 발견하고, 서버는 도구 설명자의 리스트를 돌려줘요.
진짜 MCP 서버는 stdio나 HTTP 위에서 돌고 이것을 SDK에 엮어요. 여기서는 통신 형식이 구체적이도록 표준 라이브러리 json 모듈로 메시지를 만들고 해석해요. 함수 세 개를 써요.
build_request(id, method, params)-> 봉투{"jsonrpc": "2.0", "id": id, "method": method, "params": params}의 JSON 문자열.json.dumps를 쓰세요.parse_response(text)-> 글을json.loads하고,jsonrpc == "2.0"을 요구해요(아니면ValueError).result가 있으면{"id": ..., "ok": True, "result": ...}를 돌려줘요.error가 있으면{"id": ..., "ok": False, "error": {"code": ..., "message": ...}}를 돌려줘요. 둘 다 없으면ValueError를 일으켜요.list_tools_request(id)-> 도구 발견 요청: 메서드"tools/list"와 빈params{}로 한build_request.
build_request가 문자열을 돌려주니, 테스트는 그것을 json.loads로 다시 해석해 dict를 비교해요. 그래서 키 순서는 상관없어요. 결과와 오류가 둘 다 왕복하고, 발견 요청에 올바른 메서드가 있고, jsonrpc가 빠졌거나 result도 error도 없는 메시지가 오류를 일으키도록 하세요.
json 모듈로 MCP식 JSON-RPC 2.0 메시지를 만들고 해석하세요. build_request(id, method, params)는 {"jsonrpc": "2.0", "id", "method", "params"}의 JSON 문자열을 돌려줘요. parse_response(text)는 글을 불러오고, jsonrpc == "2.0"을 요구하고(아니면 ValueError), 결과면 {"id", "ok": True, "result"}를, 오류면 {"id", "ok": False, "error": {"code", "message"}}를 돌려주고, 둘 다 없으면 오류를 일으켜요. list_tools_request(id)는 (악수 뒤에 보내는) 빈 params의 tools/list 발견 요청을 돌려줘요.
이 연습은 곧 열려요
앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.
이 브라우저가 learn.floati.life의 쿠키를 막고 있어서, 여기서 마친 레슨들이 순서대로 열리지 않아요. 이 사이트의 쿠키를 허용하고 새로고침하세요.