Next-BlockChain

MCP 서버에 도구 정의하기: FastMCP + Pydantic 으로 JSON 스키마 자동 생성지난 강의들에서 우리는 Claude API 에 직접 JSON 스키마를 손으로 적어 도구를 등록했어요 (post 23 의 Tool schemas). name, description, input_schema 까지 다 짰죠. 작은 프로젝트엔 괜찮지만, 도구가 10개 20개 되면 반복 작업 이 엄청납니다.MCP (Model Context Protocol) Python SDK 가 이걸 우아하게 해결해줘요. 데코레이터 + 타입 힌트 만 쓰면 SDK가 JSON 스키마를 자동 생성 합니다. Python 개발자에게 자연스러운 방식으로 도구를 정의할 수 있게 되는 거죠.오늘은 FastMCP 로 서버 띄우는 법, @mcp.tool..

AI 2026. 5. 31. 22:42

Claude PDF Support: 이미지 처리 코드 4줄만 바꾸면 PDF 분석기 완성지난 글들에서 이미지 입력 까지 다뤘어요. 그런데 실제 업무에서 가장 자주 마주치는 파일 형식은 뭘까요? PDF 입니다. 계약서, 보고서, 논문, 영수증, 신분증 사본까지 — 회사 안팎의 정보가 거의 다 PDF 로 흘러다녀요.다행히 Claude 는 PDF 를 그대로 읽을 수 있습니다. 이미지를 처리하는 코드와 거의 같고, 단 4가지 키만 살짝 바꾸면 끝나요. 게다가 단순 텍스트 추출이 아니라 차트·표·이미지·문서 구조 까지 한 번에 이해합니다.오늘은 PDF 입력 코드, 이미지 vs PDF 의 차이점 4가지, Claude 가 PDF 에서 추출할 수 있는 4가지 정보 유형, 그리고 한국어 PDF·OCR·민감 정보 처리 같은..

AI 2026. 5. 30. 23:40

Multi-Index RAG: 의미 검색 + 키워드 검색을 하나로 묶는 하이브리드 파이프라인 (RRF 완전 정복)지금까지 우리는 두 가지 검색 방식을 따로 만들어왔어요. 의미 검색(Vector / Semantic) 으로 동의어·맥락을 잡고, 어휘 검색(BM25 / Lexical) 으로 정확한 키워드를 잡았죠. 그런데 운영 환경에서는 두 방식 다 필요한 경우 가 압도적으로 많습니다.오늘은 두 인덱스를 하나의 통합 검색 시스템 으로 묶는 패턴을 다룹니다. 핵심 메시지: "같은 인터페이스를 따르도록 만들고, 결과를 RRF(Reciprocal Rank Fusion) 로 합쳐라."특히 RRF 알고리즘 은 점수 체계가 다른 여러 검색기를 공정하게 합치는 표준 기법 이에요. 이 글 하나로 RRF 의 작동 원리, 가중..

AI 2026. 5. 24. 18:03

title: "Claude RAG 실습 일지 — 100줄 RAG 시스템 직접 돌려본 결과와 부딪힌 함정 (Voyage 3 RPM)"description: "33_34 통합 가이드의 RAG 파이프라인을 실제 폴더에 짜서 돌려본 후기. 전체 소스 코드, 샘플 데이터, 실 터미널 출력, Voyage 무료 등급 rate limit 해결까지."tags:ClaudeAnthropicRAGVectorIndexVoyageAIEmbeddingCosineDistancePromptEngineeringPython실습검색증강생성RateLimitClaude RAG 실습 일지 🧪 — 100줄 RAG 시스템 직접 돌려보고 부딪힌 함정까지"지난 글에서 RAG 6단계 흐름과 코드는 봤다. 그래서 — 진짜 돌려보면 어떤가?"이전 글 Cl..

AI 2026. 5. 24. 16:19

title: "Claude RAG 완벽 가이드 — 개념부터 100줄 직접 구현까지 한 번에 끝내기"description: "RAG의 6단계 파이프라인 흐름과 그것을 코드로 직접 구현하는 방법을 한 글에 통합. 청킹, 임베딩, 코사인 유사도, VectorIndex, rag_answer 함수까지 모두 포함."tags:ClaudeAnthropicRAGVectorDatabaseEmbeddingCosineSimilarityVectorIndexLLM검색증강생성PromptEngineering인공지능Claude RAG 완벽 가이드 🧭 — 개념부터 100줄 직접 구현까지 한 번에 끝내기"RAG가 뭔지 알고, 청킹·임베딩도 들었는데, 결국 사용자가 질문하면 정확히 뭐가 어떻게 돌아가는지 그림이 잘 안 그려져요. 그리고 ..

AI 2026. 5. 24. 16:06

RAG 파이프라인 5단계 직접 구현하기: 청크부터 검색까지 100줄로 완성지난 글까지 우리는 개념과 도구 를 갖췄어요. 청킹(post 31), 임베딩(post 32) 까지 끝났죠. 이제 진짜 재미있는 부분 — 그 모든 걸 합쳐서 동작하는 RAG 시스템 을 직접 구현합니다.오늘 만들 시스템은 단순합니다. 벡터 DB(Pinecone, Chroma 등) 같은 외부 의존성도 없어요. 우리가 직접 작은 VectorIndex 를 만들고, 그 안에 임베딩을 저장하고, 코사인 유사도로 검색합니다. 약 100줄짜리 RAG 가 완성돼요.오늘은 5단계 흐름 의 코드, VectorIndex 의 동작 원리, 검색 결과 해석 방법, 그리고 이 단순 구현이 운영에서 깨지는 케이스 까지 정리합니다.🎯 이 글에서 배우는 것RAG 파..

AI 2026. 5. 23. 23:38

title: "Claude RAG 파이프라인 완벽 가이드 — 청킹부터 응답 생성까지 6단계 한눈에 보기"description: "텍스트 청킹, 엠베딩, 벡터 DB, 코사인 유사도, 최종 프롬프트 결합까지 — RAG의 전체 흐름을 단계별 예제로 풀어 정리합니다."tags:ClaudeAnthropicRAGVectorDatabaseEmbeddingCosineSimilarityLLM검색증강생성PromptEngineering인공지능Claude RAG 파이프라인 완벽 가이드 🧭 — 청킹부터 응답 생성까지 6단계로 한눈에 정리"RAG가 뭔지는 알겠는데, 실제로 안에서 무슨 일이 벌어지는지 가 헷갈려요."이전 글에서 우리는 RAG(검색 증강 생성) 의 개념과 텍스트 청킹 전략 을 살펴봤습니다. 그런데 막상 "그래서 ..

AI 2026. 5. 23. 23:14

텍스트 임베딩(Text Embeddings) 입문: 의미를 숫자로 바꾸는 의미 기반 검색의 핵심 도구지난 글에서 문서를 청크로 나누는 방법 까지 배웠어요. 이제 청크들이 손에 있어요. 그런데 사용자가 질문을 던지면 수백·수천 개의 청크 중 어느 게 관련 있는지 어떻게 골라낼까요?가장 단순한 답은 키워드 검색 입니다. "버그" 라는 단어가 들어간 청크를 찾는 거죠. 하지만 사용자가 "오류" 라고 물으면? "glitch" 라고 물으면? 키워드 매칭은 동의어·맥락을 이해 못해서 막힙니다.여기서 의미 기반 검색(Semantic Search) 이 등장해요. 그리고 그 핵심 기술이 오늘의 주인공 — 텍스트 임베딩(Text Embeddings) 입니다. "의미를 숫자로 바꿔서, 비슷한 의미끼리 가까운 거리에 두는" ..

AI 2026. 5. 22. 01:51