LLM, AI 도구

MCP Client 개발 - Langchain

이전에 만든 MCP Server 용 프로그램을 Langchain에서도 사용할 수 있다.원래는 Langchain에서 도구를 사용할 때 @tool을 사용하여 도구를 각기 정의를 하던가, builtin tool를 가져다가 사용을 했었는데 이제는 Langchain 전용 도구가 아니라 MCP 도구를 사용할 수 있게 되었다.그럼 Langchain에서 이전에 만든 MCP Server를 사용할 수 있도록 Client를 한번 만들어보자.Client를 만드는 방법은 아래 주소에 잘 설명되어 있고 따라서 만들면 된다.https://github.com/langchain-ai/langchain-mcp-adapters대신 github에서 알려주는 코드 방식이 아니라 mcp_config.json이라는 파일 내에 mcp 설정정보를 ..

2025. 4. 8. 07:15
LLM, AI 도구

MCP Server 개발 - Python

https://modelcontextprotocol.io/quickstart/serverMCP로 사용할 서버를 개발해보자. 서버를 만든다는 건 도구를 만든다고 생각하면 된다.만들어볼 것날씨 조회하는 도구를 만들어보자.2가 종류를 모두 만들어보고 실행해보자.stdiosse그리고 AI Cursor와 Claude에서 MCP를 연결해보자.환경 설정우선 uv 설치하고 python 환경 구성MacOS/Linuxcurl -LsSf https://astral.sh/uv/install.sh | shWindowspowershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"uv 명령어가 제대로 인식되도록 하기 위해, 이후 터미널을 반드시 ..

2025. 4. 8. 07:00
LLM, AI 도구

MCP (Model Context Protocol)란?

요즘에 MCP가 핫하다. OpenAI도, Microsoft 등 여러 메이저기업도 MCP를 도입한다고 한다.그래서 MCP가 뭔지 찾아보니 MCP를 만든 Anthropic에서는 아래와 같이 설명하고 있다.MCP는 애플리케이션이 LLM에 컨텍스트를 제공하는 방법을 표준화하는 개방형 프로토콜이다. MCP는 AI 애플리케이션을 위한 USB-C 포트와 같다. USB-C가 다양한 주변기기와 액세서리에 기기를 연결하는 표준화된 방법을 제공하는 것처럼, MCP는 AI 모델을 다양한 데이터 소스와 도구에 연결하는 표준화된 방법을 제공한다.참고: https://modelcontextprotocol.io/introduction위의 문서 내용을 읽으면서 기본내용을 정리하고 이해가 어려운 부분은 추가적인 설명을 추가해놓았다.Wh..

2025. 4. 8. 06:58
langgraph

[langgraph] checkpointer로 SqlAlchemy 사용

langgraph에서 checkpointer로 저장 시 MemorySaver와 Redis, Postgresql용만 존재한다. 다양한 DB를 제공하기 위해 SqlAlchemy용으로 만들어 보았다.import threadingfrom typing import Any, Optional, Sequence, Tuplefrom langchain_core.runnables import RunnableConfigfrom langgraph.checkpoint.base import ( WRITES_IDX_MAP, BaseCheckpointSaver, ChannelVersions, CheckpointMetadata, CheckpointTuple, get_checkpoint_id, get..

2025. 2. 21. 10:10
개발도구(Intellij, vscode 등)

vscode에서 숨김파일 숨기기(__pycache)

vscode에서 python 개발할 때 __pycache__ 폴더가 표시되어 보기 어려운 일이 있다. 아래와 같이 보이지 않게 숨길 수 있다. 1. Settings2. files.exclude로 검색3. Text Editor > Files 하위에 "**/__pycache__"를 추가 이렇게 하면 보이지 않는다.

2025. 2. 18. 13:21
개발도구(Intellij, vscode 등)

vs code에서 python 개발환경 세팅

기존에 intellij를 사용하다가 AI Cursor때문에 vscode로 넘어갔다. 하지만 intellij에 익숙해져 있었는데 vscode의 환경이 너무 어색해서 하나씩 정리하게 되었다.project에 pythonpath 추가project root 외에 특정 폴더를 python path에 추가하는 방법이다.intellij에서는 Project Structure에서 추가할 수 있지만 vscode에는 그런 부분이 UI로 나와있지 않다.아래와 같이 settings.json에 추가할 수 있다.{ "python.analysis.extraPaths": [ "${workspaceFolder}/module1", "${workspaceFolder}/module2" ]}debug로 실행d..

2025. 2. 12. 07:48
개발도구(Intellij, vscode 등)

[python] intellij에서 auto-import가 적용되지 않을 경우

intellij에서 option+enter를 눌러 auto-import를 적용할 수 있다.근데, 해당 프로젝트 내의 import는 적용이 되는데, 설치된 package는 auto import를 추천하지 않는다. ChatOpenAI는 langchain에 있는 것인데, langchain은 이미 설치되어 있는 상태다.  여러가지 방안을 해봤는데, 잘 안되어서 intellij의 프로젝트 파일(my-project.iml)을 수정해봤다. 나의 가상환경 경로는 venv가 아니라 .venv이다. 위에서 venv를 .venv로 변경하니 적용이 되었다.

2025. 1. 24. 10:04
python

python의 uv 사용법

uv는 python 패키지 설치 및 관리, 빌드, 배포까지 가능하며 엄청난 속도를 자랑합니다.https://github.com/astral-sh/uvuv는 pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv 등을 대체할 하나의 도구이다.pip보다 10-100배 빠르다.python 애플리케이션에서 실행 및 설치된다.설치macOS 또는 Linux# On macOS and Linux.curl -LsSf https://astral.sh/uv/install.sh | sh또는 brew install uvWindows# On Windows.powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps..

2025. 1. 21. 09:43
여러가지

git push시 400 오류

git push 시 아래의 오류가 발생하는 경우가 있다.Push failed Total 22 (delta 6), reused 0 (delta 0) RPC failed; HTTP 400 curl 22 The requested URL returned error: 400 the remote end hung up unexpectedly the remote end hung up unexpectedly원인을 확인해보니 git 은 전송 가능한 버퍼 최대 사이즈의 기본값을 1MB으로 설정한다.그래서 아래와 같이 512MB로 설정을 변경한다.git config http.postbuffer 524288000다시 해보니 잘 된다.

2025. 1. 8. 20:16
여러가지

linux 파일 용량 조회

하위 디렉토리 용량 확인/ 하위 디렉토리 용량 확인du -hs /*linux에서 파일용량이 큰 디렉토리를 조회/에서 찾기du -sh /* 2>/dev/null | sort -h특정 크기 이상의 파일 찾기/에서 100M 이상의 파일 찾기find / -type f -size +100M 2>/dev/null

2025. 1. 6. 13:12
python

intellij에서 jupyter notebook 사용하기

IntelliJ에서 Jupyter Notebook을 사용하는 방법을 알아보자.1. 사전 준비Jupyter Notebook을 IntelliJ에서 사용하려면 몇 가지 설정이 필요하다.(1) IntelliJ 설치 및 플러그인 추가IntelliJ IDEA Ultimate 버전 또는 PyCharm Professional 버전을 사용하는 것이 좋다. 이후, Jupyter 관련 플러그인을 설치한다.IntelliJ 상단 메뉴에서 File > Settings > Plugins로 이동한다.Marketplace에서 "Jupyter"를 검색한 뒤 설치한다.설치 후 IDE를 재시작한다.2. IntelliJ에서 Jupyter Notebook 설정하기(1) Python 인터프리터 설정File > Project Structure >..

2025. 1. 2. 07:56
langgraph

[langgraph] 처음부터 ReAct 에이전트를 만드는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/react-agent-from-scratch/기본 제공되는 ReAct 에이전트(create_react_agent)를 사용하는 것은 시작하기에 훌륭하지만, 때때로 더 많은 제어와 사용자화가 필요할 수 있다. 그런 경우에는 사용자 정의 ReAct 에이전트를 만들 수 있다. 이 가이드는 LangGraph를 사용하여 ReAct 에이전트를 처음부터 구현하는 방법을 보여준다.준비우선, 필요한 패키지를 설치하자.pip install langgraph langchain-openai..

2024. 12. 3. 07:56
langgraph

[langgraph] ReAct 에이전트에 사람이 개입하는 프로세스를 추가하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/create-react-agent-hitl/이 가이드는 ReAct 에이전트에 사람이 개입하는 프로세스를 추가하는 방법을 보여준다. ReAct 에이전트를 시작하는 방법에 대한 튜토리얼은 이 링크를 참조하자.도구가 호출되기 전에 중단점을 추가하려면 create_react_agent에 interrupt_before=["tools"]를 전달하면 된다. 이 기능이 작동하려면 체크포인터를 사용해야 한다.준비우선, 필요한 패키지를 설치하자.pip install langgraph ..

2024. 12. 3. 07:55
langgraph

[langgraph] ReAct 에이전트에 사용자 정의 시스템 프롬프트 추가하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/create-react-agent-system-prompt/여기서는 ReAct 에이전트에 사용자 정의 시스템 프롬프트를 추가하는 방법을 보여준다. ReAct 에이전트를 시작하는 방법에 대한 튜토리얼은 이 링크를 참조하자.사용자 정의 시스템 프롬프트는 state_modifier 파라미터에 문자열을 전달함으로써 추가할 수 있다.준비우선, 필요한 패키지를 설치하자.pip install langgraph langchain-openai코드from dotenv import lo..

2024. 12. 3. 07:54
langgraph

[langgraph] ReAct 에이전트에 메모리 추가하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/create-react-agent-memory/이 가이드는 미리 구축된 ReAct 에이전트에 메모리를 추가하는 방법을 설명한다. 미리 구축된 ReAct 에이전트를 시작하는 방법에 대한 튜토리얼은 이 링크를 참조하라.메모리는 create_react_agent 함수에 체크포인터(checkpointer)를 전달함으로써 에이전트에 추가할 수 있다.준비우선, 필요한 패키지를 설치하자.pip install langgraph langchain-openai코드# First we i..

2024. 12. 3. 07:53
langgraph

[langgraph] ReAct 에이전트를 사용하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/create-react-agent/여기서는 날씨를 확인할 수 있는 간단한 ReAct 에이전트 앱을 만들 것이다. 이 앱은 에이전트(LLM)와 도구들로 구성된다. 앱과 대화할 때, 먼저 에이전트(LLM)를 호출하여 도구를 사용할지 여부를 결정한다. 그런 다음 다음과 같은 루프를 실행한다.에이전트가 행동을 취하라고 말한 경우(즉, 도구를 호출해야 할 경우), 도구를 실행하고 결과를 에이전트에 전달한다.에이전트가 도구를 실행하라고 하지 않은 경우, 작업을 완료하고 사용자에..

2024. 12. 3. 07:52
langgraph

[langgraph] AutoGen, CrewAI 외 다른 프레임워크와 LangGraph 통합하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/autogen-integration/LangGraph는 에이전트 기반 및 다중 에이전트 애플리케이션을 구축하기 위한 프레임워크이다. 여기에는 다른 에이전트 프레임워크와의 통합도 포함된다.이 가이드는 LangGraph를 다른 프레임워크와 통합하는 방법을 보여준다. 여기서 통합하는 프레임워크는 AutoGen이지만, 다른 프레임워크와도 쉽게 통합할 수 있다.전체적인 흐름은 다른 에이전트를 LangGraph 노드 안에 래핑하는 방식이다. LangGraph의 노드는 임의의 코..

2024. 12. 3. 07:50
langgraph

[langgraph] 재귀 횟수에 도달하기 전에 상태를 리턴하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/return-when-recursion-limit-hits/그래프 재귀 제한을 설정하면 그래프 실행 시간을 제어할 수 있지만, 재귀 제한에 도달하면 그래프가 오류를 반환하게 된다. 모든 사용 사례에서 좋은 방법은 아니다. 대신, 재귀 제한에 도달하기 직전의 상태 값을 반환하도록 설정할 수 있다. 여기서는 이를 구현하는 방법을 보여준다.준비우선, 필요한 패키지를 설치하자.pip install langgraph 상태를 리턴하기 않기이 예제에서는 항상 재귀 제한에 도달하는..

2024. 12. 3. 07:48
langgraph

[langgraph] LangSmith에서 그래프 실행 시 실행 ID(runID), 태그(tag)와 메타데이터(metadata)를 전달하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/run-id-langsmith/그래프 실행을 디버깅하는 것은 IDE나 터미널에서 어려울 수 있다. LangSmith를 사용하면 LangGraph로 구축한 LLM 앱의 실행 데이터를 디버깅, 테스트 및 모니터링할 수 있다. 시작하는 방법에 대한 자세한 내용은 LangSmith 문서를 참조하자.그래프 호출 중 생성된 실행 데이터를 더 쉽게 식별하고 분석할 수 있도록, 실행 시점에 추가 구성 설정을 지정할 수 있다(참조: RunnableConfig).필드타입설명run_na..

2024. 12. 3. 07:47
langgraph

[langgraph] ReAct 스타일 에이전트로 구조화된 출력을 리턴하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/react-agent-structured-output/에이전트의 출력을 구조화된 형식으로 반환해야 할 때가 있을 수 있다. 예를 들어, 에이전트의 출력이 다른 다운스트림 소프트웨어에서 사용되는 경우, 에이전트가 호출될 때마다 동일한 구조화된 형식으로 출력을 제공하도록 하면 일관성을 유지할 수 있다.여기서는 툴 호출 에이전트의 출력을 구조화된 형식으로 강제하는 두 가지 방법을 알아보자. 기본 ReAct 에이전트(모델 노드와 툴 호출 노드)를 사용하며, 마지막에는 사용자..

2024. 12. 3. 07:44
728x90
반응형