Ollama MCP 데이터베이스 어시스턴트

Ollama의 LLM 기능과 MCP(Model Context Protocol)를 통한 PostgreSQL 데이터베이스 접근을 결합한 대화형 채팅 인터페이스입니다. 자연어로 데이터에 대해 질문하고 실제 SQL 쿼리를 기반으로 AI 기반 답변을 받아보세요.

특징

• PostgreSQL 데이터베이스에 대한 자연어 인터페이스
• 자동 SQL 쿼리 생성
• 스키마 인식 응답
• 대화형 채팅 인터페이스
• 안전한 읽기 전용 데이터베이스 액세스

필수 조건

• Node.js 16 이상
• 실행 중인 PostgreSQL 데이터베이스
• Ollama가 로컬에 설치 및 실행됨
• Ollama에서 가져온 qwen2.5-coder:7b-instruct 모델

설정

1. 저장소를 복제합니다.

지엑스피1

2. 종속성 설치:

3. 필요한 Ollama 모델을 가져옵니다.

4. 프로젝트 루트에 .env 파일을 만듭니다.

용법

1. 채팅 인터페이스를 시작합니다.

2. 자연어로 데이터에 대한 질문을 해보세요.

3. 애플리케이션을 종료하려면 'exit'를 입력하세요.

작동 원리

1. 이 애플리케이션은 PostgreSQL MCP 서버를 통해 PostgreSQL 데이터베이스에 연결됩니다.
2. 데이터베이스 스키마를 로드하고 캐시합니다.
3. 질문을 할 때:
   • 스키마와 질문은 Ollama에게 전송됩니다.
   • Ollama는 적절한 SQL 쿼리를 생성합니다.
   • 쿼리는 MCP를 통해 실행됩니다.
   • 결과는 해석을 위해 Ollama로 다시 전송됩니다.
   • 자연어 응답을 받습니다.

환경 변수

보안

• 모든 데이터베이스 액세스는 읽기 전용입니다.
• SQL 쿼리는 SELECT 문으로 제한됩니다.
• 데이터베이스 자격 증명은 .env 파일에 안전하게 보관됩니다.

개발

다음으로 구성됨:

• 타입스크립트
• 모델 컨텍스트 프로토콜(MCP)
• 올라마
• 포스트그레스큐엘

문제 해결

일반적인 문제

1. "데이터베이스에 연결하지 못했습니다."
   • .env에서 DATABASE_URL을 확인하세요.
   • PostgreSQL이 실행 중인지 확인하세요
   • 네트워크 연결 확인
2. "Ollama에 연결하지 못했습니다"
   • Ollama가 실행 중인지 확인하세요( ollama serve )
   • 모델이 설치되었는지 확인하세요( ollama list )
3. "쿼리 실행 중 오류"
   • 데이터베이스 권한 확인
   • 스키마에서 테이블/열 이름 확인

특허

MIT

기여하다

1. 저장소를 포크하세요
2. 기능 브랜치를 생성하세요
3. 변경 사항을 커밋하세요
4. 지점으로 밀어 넣기
5. 풀 리퀘스트 열기