대화 기록을 원문 그대로 저장하고 의미 검색으로 찾아주는 로컬 우선 AI 메모리 시스템으로, MCP 서버와 CLI를 제공합니다.
nlweb-ai/NLWeb
웹사이트에 자연어 대화형 인터페이스를 추가하고 MCP 클라이언트도 지원하는 프로토콜 및 툴킷 NLWeb의 Python 레퍼런스 구현입니다.
- 스타
- 6,258
- 포크
- 695
- 열린 이슈
- 65
- 마지막 커밋
- 2개월 전
어떤 프로젝트인가요?
NLWeb은 웹사이트에 대화형 인터페이스를 구축하기 위한 개방형 프로토콜과 샘플 코드 모음입니다. 사이트가 이미 게시하는 Schema.org 및 RSS 마크업을 활용해, 페이지의 구조화된 데이터를 바탕으로 자연어 질문에 답할 수 있습니다. NLWeb 인스턴스는 MCP 서버로도 동작하며 ask 메서드를 제공하므로, 하나의 엔드포인트로 사용자와 AI 에이전트를 모두 지원합니다.
이 저장소는 Python 레퍼런스 구현입니다. AskAgent 모듈은 OpenAI, DeepSeek, Gemini, Anthropic 등 여러 LLM 제공업체와 Qdrant, Milvus, Elasticsearch, Postgres 같은 벡터 스토어를 연결해 자연어 질의를 처리합니다. 그 밖에 에이전트 검색, HubSpot·Dynamics 365·Jira 같은 엔터프라이즈 데이터 소스에 대한 자연어-SQL 변환, LLM 모델 라우팅, 검색 결과의 신경망 기반 점수화 모듈도 포함되어 있습니다. Windows, macOS, Linux에서 실행되며 샘플 웹 UI도 제공합니다.
이 코드는 완성된 제품이 아니라 개념 증명을 목적으로 합니다. 프로덕션 환경에 배포할 때는 자체 프런트엔드를 사용하고 NLWeb을 실제 데이터베이스에 연결하는 것이 전제입니다.
핵심 기능
- 01각 사이트를 자연어 질문용 ask 메서드를 제공하는 MCP 서버로 노출합니다.
- 02사이트에 이미 있는 Schema.org 구조화 데이터를 사용해 질의에 답합니다.
- 03YAML 설정으로 여러 LLM 제공업체와 벡터 스토어를 연결합니다.
- 04HubSpot, Dynamics 365, Jira의 데이터를 대상으로 자연어-SQL 변환을 지원하는 DataFinder가 포함되어 있습니다.
- 05로컬 테스트용 샘플 웹 UI와 데모 데이터 소스를 제공합니다.
활용 사례
- 제품 카탈로그나 레시피 사이트처럼 콘텐츠가 많은 웹사이트에 대화형 검색창을 추가합니다.
- 표준 MCP 엔드포인트를 통해 AI 에이전트가 웹사이트에 질의하도록 합니다.
- 엔터프라이즈 CRM 또는 이슈 트래킹 데이터에 대한 자연어 접근을 프로토타이핑합니다.
빠른 시작
- 1
노트북에서 실행하려면 hello-world 가이드(docs/nlweb-hello-world.md)를 따르세요
사용 전 알아둘 점
- 이 프로젝트는 개념 증명용 참조 구현이며, README에는 커뮤니티가 더 나은 대안을 만들 것으로 기대한다고 나와 있습니다.
- 실행하려면 LLM 제공자와 벡터 저장소를 구성해야 하므로 직접 호스팅에 수고가 듭니다.
- README에 따르면 CI/CD 파이프라인은 아직 포함되어 있지 않습니다.
토픽
자주 묻는 질문
- NLWeb은(는) 무엇인가요?
- 웹사이트에 자연어 대화형 인터페이스를 추가하고 MCP 클라이언트도 지원하는 프로토콜 및 툴킷 NLWeb의 Python 레퍼런스 구현입니다. NLWeb은 웹사이트에 대화형 인터페이스를 구축하기 위한 개방형 프로토콜과 샘플 코드 모음입니다. 사이트가 이미 게시하는 Schema.org 및 RSS 마크업을 활용해, 페이지의 구조화된 데이터를 바탕으로 자연어 질문에 답할 수 있습니다. NLWeb 인스턴스는 MCP 서버로도 동작하며 ask 메서드를 제공하므로, 하나의 엔드포인트로 사용자와 AI 에이전트를 모두 지원합니다.
- NLWeb은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- NLWeb은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- NLWeb은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. NLWeb의 마지막 커밋은 2026년 8월 11일입니다.
- NLWeb은(는) 어디에 사용할 수 있나요?
- 제품 카탈로그나 레시피 사이트처럼 콘텐츠가 많은 웹사이트에 대화형 검색창을 추가합니다. 표준 MCP 엔드포인트를 통해 AI 에이전트가 웹사이트에 질의하도록 합니다. 엔터프라이즈 CRM 또는 이슈 트래킹 데이터에 대한 자연어 접근을 프로토타이핑합니다.
- NLWeb는 어떻게 설치하나요?
- 노트북에서 실행하려면 hello-world 가이드(docs/nlweb-hello-world.md)를 따르세요
- NLWeb은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/nlweb-ai/NLWeb
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
로컬 Ollama 모델 및 OpenAI 호환 API와 채팅할 수 있는 자체 호스팅·제공자 독립형 웹 인터페이스로, RAG, 플러그인, 다중 사용자 접근 제어를 지원합니다.
문서, 코드, 대화를 AI 에이전트용 셀프 호스팅 지식 그래프로 바꾸는 오픈소스 AI 메모리 플랫폼입니다.
LangGraph에서 복잡한 다단계 작업을 바로 실행할 수 있는, 필요한 기능을 모두 갖춘 Python용 에이전트 하네스입니다.
Python 코드로 동작을 작성하고 실행하는 AI 에이전트를 만들기 위한 미니멀한 Python 라이브러리입니다.