마시멜로

Claude 모델이 MCP (Model Context Protocol) 클라이언트로 사용되는 상황을 전제로,FastAPI 기반 MCP-compatible 서버를 포함한 전체 구조와 샘플 코드를 Claude와 연동 가능한 형식으로 다시 정리🧠 Claude × Model Context Protocol (MCP) 연동 개발 가이드📌 핵심 요약LLM ClientClaude (Anthropic)MCP ServerFastAPI 앱 (JSON-RPC 2.0)Toolsfetch_github_issues, etc.TransportHTTP (or WebSocket)FormatJSON-RPC v2Claude는 tool.list, tool.call, resource.list 등의 메시지를 통해 외부 서버에 기능 요청을 합..

**Model Context Protocol (MCP)**는 Anthropic이 주도하여 설계한 AI와 외부 시스템 간의 상호작용을 위한 오픈 프로토콜입니다. 이 프로토콜은 특히 LLM이 외부 도구·리소스와 안전하고 일관된 방식으로 상호작용할 수 있게 해줍니다.아래는 MCP 개발 배경, 구조, 작동 방식, 개발 방법 및 예시까지 자세하게 정리한 내용입니다.🧠 MCP란 무엇인가?**MCP (Model Context Protocol)**는:LLM이 외부 세계에 안전하게 연결되도록 설계된 표준 통신 프로토콜입니다.클라이언트 ↔ 서버 (LLM ↔ Tool) 구조에서 모델이 서버에게 도구 사용 요청을 보낼 수 있습니다.JSON-RPC 기반 메시지 규격을 따르며, 다양한 리소스, 툴, 프롬프트, 샘플링을 통합 관..

✅ 무엇인가요?**MCP(Model Context Protocol)**는 특히 **대형 언어 모델(LLM)**이 외부 도구나 데이터 소스와 효율적으로 상호작용할 수 있도록 돕는 표준화된 오픈 프로토콜입니다. 즉, AI 모델이 다양한 시스템과 일관되게 통신하고 기능을 사용할 수 있도록 설계된 규약입니다.🧩 MCP의 주요 특징🌐 1. 오픈 스탠다드MCP는 어떤 회사나 플랫폼에 종속되지 않는 개방형 표준입니다.이로 인해 다양한 회사와 플랫폼이 자유롭게 사용하고 통합할 수 있습니다.🔌 2. AI와 도구 간 통신MCP는 **AI 모델(예: ChatGPT, Claude 등)**과 외부 시스템/도구(예: Google Drive, Jira, GitHub 등) 사이의 커뮤니케이션을 가능하게 합니다.🧠 3. 컨텍스..

"Java처럼 협업 중심의 API 개발" — 즉, **타입 안전성, 명세 기반 개발, 명확한 계약(contract)**을 원하신다면 아래 포인트들을 고려해봐야 해요:🎯 목표: Java식 협업 API 스타일이란?팀원이 서로 **계약(Interface)**을 기반으로 개발 (Ex. Swagger / OpenAPI 기반)API 스펙이 자동 문서화되고, 프론트엔드/백엔드가 명확한 경계로 개발 가능입력/출력 타입이 명확해서 IDE 자동완성, 타입검사, 테스트 용이Mock 서버나 클라이언트 코드 자동 생성도 가능🔥 그럼 무엇을 써야 할까?기준추천Python 기반 + Java스러운 협업 경험✅ FastAPISpring 수준의 타입 안정성과 문서화✅ FastAPI + Pydantic + OpenAPI복잡한 API,..

FastAPI와 Flask는 모두 Python 기반의 웹 프레임워크지만, 철학, 성능, 생산성 면에서 큰 차이점이 있어요.⚔️ FastAPI vs Flask 비교표항목FastAPIFlask🚀 속도매우 빠름 (Starlette 기반, 비동기 지원)보통 (동기 기반)🧠 타입 지원✅ 강력한 타입 힌트 (Pydantic)❌ 타입 지원 거의 없음📝 문서 자동화✅ Swagger UI, ReDoc 자동 생성❌ 수동으로 Swagger 설정 필요🧵 비동기 처리✅ async/await 완전 지원⚠️ 제한적 (기본은 동기)👨‍🔧 개발자 경험매우 뛰어남 (IDE 자동완성, 타입 검사)단순하고 익숙함🏗️ 설계 철학현대적인, 명시적, 타입기반 API최소주의, 자유로운 설계🧪 유효성 검사자동 (Pydantic 모델)..

SHAP은 머신러닝 모델이 왜 그런 예측을 했는지 설명해주는 도구예요.특히 XGBoost나 LightGBM 같은 블랙박스 모델의 예측 결과를 해석할 수 있게 해줘요.🧠 SHAP이란?🔍 SHAP = SHapley Additive exPlanations원래는 게임 이론의 Shapley 값에서 나온 개념이에요."각 피처가 예측값에 얼마나 기여했는가?"를 계산합니다.예:모델이 전표 A를 "반려 확률 90%"로 예측했다면:적요: +40%금액: +20%계정코드: +30%→ 이런 식으로 기여도를 보여줘요.📊 어떻게 생겼냐면?예시 그래프:예측: 반려 확률 90%-------------------------적요 +0.40계정코드 +0.30금액 +0.20거래처..

✅ 1. 문제 정의입력(Input): 전표 데이터 (예: 적요, 금액, 계정과목, 날짜, 작성자 등)출력(Output): 반려 여부 (반려/통과 → 이진 분류)이 문제는 이진 분류(Binary Classification) 문제입니다.✅ 2. 데이터 준비🎯 타겟 변수 설정label = 1 : 반려됨 (결재반려, 재경반려)label = 0 : 정상 통과됨🧾 입력 피처 예시적요 (자연어 처리 필요)금액 (숫자형)계정코드, 거래처 (범주형)입력일자 (날짜 → 요일/월/분기 등으로 파생 가능)사용자 ID, 부서 ID (범주형)반려 사유 (학습 시 제외하고, 추후 해석에만 사용 가능)✅ 3. 전처리/특징 엔지니어링적요: TF-IDF, BERT 임베딩, 혹은 SentenceTransformer 등으로 변환범주형:..

XGBoost 모델에서의 피처(Feature) 관리 중요성XGBoost는 머신러닝 분야에서 널리 사용되는 강력한 알고리즘 중 하나로, 높은 예측 성능과 빠른 처리 속도로 많은 주목을 받고 있습니다. 하지만 모델을 성공적으로 구축하고 활용하기 위해서는 피처(Feature) 관리가 매우 중요합니다. 특히 모델 학습 시 사용한 피처와 예측 시 사용하는 피처가 반드시 일치해야 한다는 점을 반드시 기억해야 합니다.학습 피처와 예측 피처가 동일해야 하는 이유XGBoost는 지도 학습(Supervised Learning) 기반으로 동작하며, 훈련 데이터에서 피처를 학습하여 각 피처가 예측에 얼마나 중요한지 학습합니다. 따라서 예측 단계에서도 학습 시와 동일한 피처를 동일한 순서와 구조로 입력받아야 정확한 예측을 수행..

AI 기반 추천 시스템은 사용자의 과거 행동과 선호도를 분석하여 개인화된 추천을 제공하는 시스템입니다. 이 시스템은 크게 데이터 수집, 데이터 처리 및 전처리, 모델 훈련, 추천 예측의 단계로 나눌 수 있습니다. 이 글에서는 AI 기반 추천 시스템을 구축하기 위한 AI 아키텍쳐와 Python 코드 예시를 제공합니다.1. AI 기반 추천 시스템 아키텍쳐1.1. 데이터 수집추천 시스템의 첫 번째 단계는 데이터를 수집하는 것입니다. 사용자 행동 데이터(구매 이력, 클릭 이력, 검색 기록 등), 상품 정보, 사용자 프로필 데이터 등을 수집하여 모델 훈련에 사용할 수 있습니다. 데이터를 DB나 파일 시스템에서 읽어옵니다.1.2. 데이터 전처리수집된 데이터는 모델 학습에 적합하도록 전처리가 필요합니다. 전처리 과정..

AI를 통한 사용자의 구매 이력 및 선호도를 기반으로 하는 상품 추천 모델과 전통적인 DB 검색 방식은 상품을 추천하는 데 각기 다른 접근 방식과 장점을 가집니다. 아래는 이 두 방법을 비교한 내용입니다.1. AI 기반 추천 시스템 (구매 이력 및 선호도 기반)AI 기반 추천 시스템은 사용자의 구매 이력, 검색 패턴, 선호도 등을 학습하여, 개별 사용자의 특성에 맞춘 상품을 추천하는 시스템입니다. 일반적으로 기계학습(Machine Learning) 또는 딥러닝(Deep Learning) 기법을 사용하여, 사용자의 데이터를 바탕으로 상품을 추천합니다.장점개인화된 추천: AI 모델은 사용자의 과거 행동(구매, 클릭, 장바구니에 담은 상품 등)을 기반으로 추천합니다. 예를 들어, 특정 카테고리나 브랜드에 대한..