04. Model Context Protocol (MCP) & A2A

class MockMCPServer:
    def __init__(self, name: str):
        self.name = name
        self.users = {
            "user_1": {"name": "Alice", "email": "alice@example.com"},
            "user_2": {"name": "Bob", "email": "bob@example.com"}
        }
 
    def list_tools(self) -> List[Dict]:
        """탐색: 이 서버가 무엇을 할 수 있는가?"""
        return [
            {
                "name": "get_user_info",
                "description": "ID로 사용자 정보 조회",
                "input_schema": {
                    "type": "object",
                    "properties": {"user_id": {"type": "string"}},
                    "required": ["user_id"]
                }
            }
        ]
 
    def call_tool(self, tool_name: str, arguments: Dict) -> str:
        """도구 실행 및 결과 반환"""
        if tool_name == "get_user_info":
            user = self.users.get(arguments["user_id"])
            return json.dumps(user) if user else "User not found"

class MCPClient:
    def __init__(self, server: MockMCPServer):
        self.server = server
 
    def run(self, query: str):
        # 1. 탐색 단계
        tools = self.server.list_tools()
 
        # 2. OpenAI 형식으로 변환
        openai_tools = [{
            "type": "function",
            "function": {
                "name": t["name"],
                "description": t["description"],
                "parameters": t["input_schema"]
            }
        } for t in tools]
 
        # 3. LLM이 결정하고 실행
        # ... (도구 호출 에이전트 루프)

class ResearchAgent:
    """자신을 도구로 노출하는 에이전트"""
 
    def as_tool(self) -> Dict:
        return {
            "name": "ask_researcher",
            "description": "리서치 에이전트에게 정보 검색 요청",
            "input_schema": {
                "type": "object",
                "properties": {
                    "query": {"type": "string"}
                }
            }
        }
 
    def invoke(self, query: str) -> str:
        # 이 에이전트가 자체 리서치 수행
        return self._search_and_summarize(query)
 
# 매니저가 이제 ResearchAgent를 도구로 사용 가능!
manager_tools = [research_agent.as_tool()]

// claude_desktop_config.json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token"
      }
    }
  }
}