STDIO 모드로 커스텀 MCP Provider 구현하기

MCP의 개념을 확인하고 증명(PoC)하기 위한 예제로 JSON-RPC를 이용해서 MCP Provider를 구현합니다

• 커스텀 MCP Provider 동작 흐름

 

 

 

• MCP 서버의 실행 방식 - "실행 및 구현 방식" 관점

 

 

• STDIO(Standard Input/Output) 모드란?

 

 

• MCP 표준 메서드
  • Specification - Model Context Protocol

Specification - Model Context Protocol

 

 

 

 

• 요청 / 응답 형식

 

 

 

• Notion MCP Provider Tools
  • https://developers.notion.com/docs/mcp-supported-tools

 

 

 

• MCP Provider 구현에 사용할 언어 비교 : TypeScript , Python , Java
  • https://github.com/modelcontextprotocol/typescript-sdk
  • https://github.com/modelcontextprotocol/python-sdk
  • https://github.com/modelcontextprotocol/java-sdk

 

 

 

• 커스텀 Provider 구성 요소 및 프로젝트 구조

 

 

 

• 초기화

 

 

• mcp/server stdio.js

 

 

 

• mcp/server stdio.js 설명

 

 

 

 

• Notion 객체의 구조
  • Introduction

 

 

 

• API 상세 매뉴얼 : 요청 ↔ 응답 예시

 

 

 

• Cursor에서 커스텀 MCP Provider 사용 설정

 

 

• Provider가 Cursor 에서 사용되는지 확인

 

 

 

• 5가지 Notion MCP Provider

 

 

 

 

• 정리
  • MCP(Model Context Protocol) : LLM(예: Cursor, Claude 등)이 외부 도구/데이터에 접근할 수 있도록 표준화된 프로토콜
  • MCP Provider :  이 프로토콜을 따르는 외부 서버입니다.
    • STDIO(표준입출력) 방식으로 JSON-RPC 메시지를 주고받음
    • "initialize →  tools list → tools/call" 순서로 통신
    • Notion API, DB, 내부 API 등 원하는 걸 붙일 수 있음
  • 지금 작성하신 server stdio.js는 Notion 검색 툴을 제공하는 커스텀 MCP Provider 입니다
    • tools/list → search 라는 툴을 정의
    • tools/call → 실제 Notion API 호출 후 결과 반환
    • Cursor는 이 MCP Provider를 클라이언트로 붙여서 , 자연어 → 툴 실행 → 결과 반환 흐름을 자동화

 

 

 

 

• 실습