MCP 서버 설정부터 데이터 조회까지, 실전 튜토리얼로 빠르게 익혀보세요!
개발하면서 “이거 SQLite 데이터 어떻게 연결하지?” 같은 고민해보신 적 있으시죠?
특히 Claude Desktop과 연동하려면 뭔가 설정해야 할 게 많아 보이는데… 사실 생각보다 간단합니다! 😆
MCP(Model Context Protocol)를 이용하면 SQLite 데이터베이스와 Claude Desktop을 빠르게 연결할 수 있어요.
오늘은 5분 만에 따라할 수 있는 MCP-SQLite 실전 튜토리얼을 준비했습니다!
설정부터 실제 데이터 조회까지 직접 실행하면서 익혀볼게요.
그럼 바로 시작해봅시다! 🏃💨
1. MCP-SQLite 연동을 위한 사전 준비 🛠️
SQLite와 MCP 서버를 사용하려면 몇 가지 도구가 필요합니다.
설치 과정은 OS에 따라 다르니, 사용하는 환경에 맞게 진행하세요!
📌 필수 도구
✅ Claude Desktop 최신 버전
✅ uv 0.4.18 이상 (터미널에서 uv --version으로 확인 가능)
✅ Git 설치 (git --version으로 확인)
✅ SQLite 설치 (sqlite3 --version으로 확인)
✅ macOS 설치 방법
brew install uv git sqlite3
✅ Windows 설치 방법
winget install --id=astral-sh.uv -e
winget install git.git sqlite.sqlite
이제 MCP와 SQLite를 사용할 준비가 완료되었습니다! 🚀
2. 샘플 SQLite 데이터베이스 생성하기 📂
이제 SQLite를 활용할 수 있도록 테스트용 데이터베이스를 만들어볼게요.
📌 macOS 사용자
sqlite3 ~/test.db <<EOF
CREATE TABLE products (
id INTEGER PRIMARY KEY,
name TEXT,
price REAL
);
INSERT INTO products (name, price) VALUES
('Widget', 19.99),
('Gadget', 29.99),
('Gizmo', 39.99),
('Smart Watch', 199.99),
('Wireless Earbuds', 89.99),
('Portable Charger', 24.99);
EOF
📌 Windows 사용자
$sql = @'
CREATE TABLE products (
id INTEGER PRIMARY KEY,
name TEXT,
price REAL
);
INSERT INTO products (name, price) VALUES
('Widget', 19.99),
('Gadget', 29.99),
('Gizmo', 39.99),
('Smart Watch', 199.99),
('Wireless Earbuds', 89.99),
('Portable Charger', 24.99);
'@
cd ~
& sqlite3 test.db $sql
이제 test.db라는 데이터베이스가 생성되었어요! 🎉
3. Claude MCP 설정 파일 수정하기 ⚙️
이제 Claude Desktop에서 SQLite MCP 서버를 사용할 수 있도록 설정을 추가해야 합니다.
📌 macOS 설정 파일 수정
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
📌 Windows 설정 파일 수정
code $env:AppData\Claude\claude_desktop_config.json
📌 설정 파일에 다음 코드 추가
{
"mcpServers": {
"sqlite": {
"command": "uvx",
"args": ["mcp-server-sqlite", "--db-path", "C:\\Users\\YOUR_USERNAME\\test.db"]
}
}
}
이제 SQLite 데이터베이스를 MCP 서버로 연동할 준비 완료! 💪
4. MCP 서버 실행 및 연결 확인 🔄
이제 MCP 서버를 실행하고, 제대로 동작하는지 확인해볼게요!
📌 MCP 서버 실행 (macOS & Windows 공통)
uvx mcp-server-sqlite --db-path ~/test.db
성공적으로 실행되었다면 Claude Desktop과의 연결을 확인해봅시다.
📌 Claude Desktop에서 다음 질문 입력
데이터베이스에서 사용 가능한 제품과 가격을 알려줄 수 있나요?
정상적으로 설정되었다면, SQLite 데이터베이스에서 정보를 가져와서 Claude가 응답할 거예요! 🎉
5. MCP를 통한 데이터 요청 흐름 이해하기 🔍
SQLite 데이터베이스와 Claude Desktop이 상호작용하는 방식은 다음과 같습니다.
1️⃣ Claude Desktop이 MCP 서버 검색
2️⃣ MCP 서버가 SQLite와 연결 초기화
3️⃣ Claude Desktop이 쿼리 요청 (SELECT * FROM products;)
4️⃣ MCP 서버가 데이터 조회 및 반환
5️⃣ Claude Desktop이 사용자에게 결과 표시
✅ MCP는 특정 기능만 제공하며, 로컬에서 실행되어 보안적으로도 안전합니다.
6. 추가 기능: PostgreSQL과 파일 시스템 연동 📡
SQLite뿐만 아니라, PostgreSQL이나 로컬 파일 시스템과도 연결 가능합니다!
설정 파일을 다음과 같이 수정하면 확장된 기능을 활용할 수 있어요.
📌 파일 시스템 연동
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/YOUR_USERNAME/Desktop"]
}
📌 PostgreSQL 연동
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
}
이제 SQLite뿐만 아니라, 다양한 데이터 소스를 MCP와 함께 사용할 수 있습니다! 🚀
🛠️ MCP-SQLite 연동, 이건 꼭 알아두세요!
❓ Claude MCP와 SQLite를 연결했는데 데이터가 안 나옵니다!
👉 설정 파일 경로를 확인하세요!
claude_desktop_config.json에서"db-path"가 올바르게 설정되었는지 확인- SQLite 데이터베이스가 존재하는지 확인 (
sqlite3 ~/test.db ".tables"입력)
❓ MCP 서버가 실행되지 않아요!
👉 uv 및 SQLite가 설치되었는지 확인하세요!
uv --version,sqlite3 --version으로 설치 확인- 실행할 때 오류 메시지가 뜬다면 로그 (
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log) 확인
❓ SQLite 외에 다른 데이터베이스도 연동할 수 있나요?
👉 가능합니다!
- PostgreSQL (
postgresql://), MySQL 등도 연동 가능 - 설정 파일에서 추가적인 MCP 서버 설정하면 쉽게 연결 가능
🚀 Claude MCP, 실무에서 어떻게 활용할 수 있을까요?
MCP는 단순한 데이터 연동을 넘어서, 다양한 시스템과 Claude를 연결하는 강력한 인터페이스입니다.
SQLite뿐만 아니라 파일 시스템, REST API, 클라우드 데이터베이스까지 확장 가능하죠!
이제 SQLite MCP 연동을 익혔으니,
✅ 실제 데이터베이스를 활용한 AI 기반 질문응답 시스템
✅ PostgreSQL과 연계한 비즈니스 데이터 분석
✅ 로컬 파일을 Claude와 연동하여 자동화된 문서 검색
등으로 응용해보면 더욱 강력한 워크플로우를 구축할 수 있습니다!