MCP 클라이언트-서버 통신

Model Context Protocol (MCP) 입문

James Chapman

AI Curriculum Manager, DataCamp

클라이언트-서버 통신

전송 방식: 표준 I/O (stdio)

서버는 자식 프로세스로 실행

전송 방식: 표준 I/O (stdio)

서버는 자식 프로세스로 실행
파이프(stdin/stdout)를 통한 통신

전송 방식: 표준 I/O (stdio)

서버는 자식 프로세스로 실행
파이프(stdin/stdout)를 통한 통신

전송 방식: 표준 I/O (stdio)

서버는 자식 프로세스로 실행
파이프(stdin/stdout)를 통한 통신
로컬 전용 - 동일 머신

전송 방식: 표준 I/O (stdio)

서버는 자식 프로세스로 실행
파이프(stdin/stdout)를 통한 통신
로컬 전용 - 동일 머신
단순하며 네트워크 설정 불필요

전송 방식: 표준 I/O (stdio)

서버는 자식 프로세스로 실행
파이프(stdin/stdout)를 통한 통신
로컬 전용 - 동일 머신
단순하며 네트워크 설정 불필요
클라이언트 종료 시 서버도 종료

전송 방식: 스트리밍 가능한 HTTP

MCP 서버: timezone_server.py

import mcp
from mcp.server.fastmcp import FastMCP
import requests

mcp = FastMCP("Timezone Converter")

@mcp.tool()
def convert_timezone(date_time: str, from_timezone: str, to_timezone: str) -> str:
    ...


if __name__ == "__main__":
    mcp.run(transport="stdio")

MCP 클라이언트: 서버 도구 목록 조회

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client


async def get_tools_from_mcp():

    # Define the server parameters
    params = StdioServerParameters(command=sys.executable, args=["timezone_server.py"])


    # Connect to the MCP server and open a session
    async with stdio_client(params) as (reader, writer):

        async with ClientSession(reader, writer) as session:

            # Initialize the session
            await session.initialize()

            # Ask the server what tools it provides
            response = await session.list_tools()

MCP 클라이언트: 서버 도구 목록 조회

async def get_tools_from_mcp():
            # ...

            # Ask the server what tools it provides
            response = await session.list_tools()

            print("Connected to MCP server!")
            print("Available tools:")
            for tool in response.tools:
                print(f" - {tool.name}: {tool.description}")

            return response.tools


asyncio.run(get_tools_from_mcp())

MCP 클라이언트: 서버 도구 목록 조회

Connected to MCP server!
Available tools:
 - convert_timezone: 
    Convert a datetime from one timezone to another.

    Args:
        date_time: The datetime string in ISO format (e.g., '2025-01-20T14:30:00')
        from_timezone: Source timezone (e.g., 'America/New_York')
        to_timezone: Target timezone (e.g., 'Europe/London')

    Returns:
        A string with the converted datetime and timezone information

MCP 클라이언트: 서버 도구 호출

async def call_mcp_tool(tool_name: str, arguments: dict) -> str:
    params = StdioServerParameters(command=sys.executable, args=["timezone_server.py"])

    async with stdio_client(params) as (reader, writer):
        async with ClientSession(reader, writer) as session:

            await session.initialize()


            result = await session.call_tool(tool_name, arguments)


            text_content = result.content[0].text

            print(f"Conversion Result: {text_content}")
            return str(text_content)

MCP 클라이언트: 서버 도구 호출

asyncio.run(
    call_mcp_tool(
        "convert_timezone",
        {"date_time": "2025-01-20T14:30:00",
         "from_timezone": "America/New_York",
         "to_timezone": "Asia/Tokyo"}
    )
)

'2025-01-21T04:30:00+09:00'

연습해 봅시다!

Model Context Protocol (MCP) 입문