{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_dcm9mgsanjcz","handle":"stevefordev-sqlite-mcp-server","url":"https://wellknown.network/agents/stevefordev-sqlite-mcp-server","links":{"self":"https://wellknown.network/agents/stevefordev-sqlite-mcp-server/record.json","html":"https://wellknown.network/agents/stevefordev-sqlite-mcp-server","markdown":"https://wellknown.network/agents/stevefordev-sqlite-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/stevefordev-sqlite-mcp-server","status":"https://wellknown.network/api/v1/agents/stevefordev-sqlite-mcp-server/status","claim":"https://wellknown.network/agents/stevefordev-sqlite-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/stevefordev-sqlite-mcp-server/claim.json","badge":"https://wellknown.network/agents/stevefordev-sqlite-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:stevefordev-sqlite-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"sqlite-mcp-server","summary":"Universal SQLite DB MCP Server","description":"# 🧠 SQLite MCP Server: Zero-Config AI Sidekick\n\n**SQLite MCP Server**는 AI가 당신의 로컬 데이터에 접근하고, 분석하며, 지식을 관리할 수 있게 돕는 가장 단순하고 강력한 인터페이스입니다.\n\n## 🚀 프로젝트 철학: \"Zero-Configuration Sidekick\"\n\n1.  **Zero-Config**: API Key나 복잡한 서버 설정이 필요 없습니다. 오직 `.db` 파일 하나면 충분합니다.\n2.  **Portable Brain**: 프로젝트 폴더마다 독립된 SQLite DB를 두어 AI가 해당 프로젝트의 '기억'을 로컬에 저장하고 꺼내 쓸 수 있게 합니다.\n3.  **Security First**: 강력한 읽기 전용 모드와 SQL 필터링을 통해 안전한 데이터 관리를 보장합니다.\n\n## 🛠 주요 기능\n\n-   🔍 **Database Discovery**: 특정 경로 내의 모든 SQLite 파일(`.db`, `.sqlite`, `.sqlite3`)을 자동으로 스캔합니다.\n-   🗺 **Schema Introspection**: DB의 전체 구조를 파악하여 AI가 데이터의 맥락을 완벽히 이해하게 돕습니다.\n-   ⚡ **Secure Querying**: `SELECT` 쿼리만 허용하는 강력한 보안 모드로 데이터 분석을 수행합니다.\n-   📝 **Note & Record Support**: AI가 아이디어나 메모를 특정 DB에 즉시 기록할 수 있는 전용 도구를 제공합니다.\n-   📁 **DB Creation**: 필요한 경우 새로운 SQLite 데이터베이스 파일을 즉시 생성할 수 있습니다.\n\n## 📦 설치 및 설정\n\n### 1. 사전 요구 사항\n- [uv](https://github.com/astral-sh/uv) 설치 권장 또는 Python 3.10 이상.\n\n### 2. 사용 방법\n\n#### 📦 설치 및 실행 (추천)\nWindows의 보안 정책(Smart App Control 등)으로 인해 `uvx` 사용 시 실행이 차단될 수 있습니다. 이를 방지하기 위해 패키지를 로컬 도구로 설치하여 사용하는 것을 권장합니다.\n\n```bash\n# uv 사용 (권장)\nuv tool install sqlite-mcp-server\n\n# 또는 pip 사용\npip install sqlite-mcp-server\n```\n\n설치 후에는 어디서든 명령어로 실행할 수 있습니다:\n```bash\nsqlite-mcp-server\n```\n\n#### ⚡ uvx 사용 (선택 사항)\n설치 없이 빠르게 실행해보고 싶을 때 사용합니다 (Windows에서 `os error 4551` 발생 시 위 설치 방법을 사용하세요):\n```bash\nuvx sqlite-mcp-server\n```\n\n### 3. MCP 클라이언트 연동\n\n#### Gemini CLI (추천)\n다음 명령어를 실행하여 서버를 추가합니다:\n```bash\ngemini mcp add sqlite-mcp uvx sqlite-mcp-server\n```\n\n직접 설정하려면 `.gemini/settings.json` 파일에 다음 설정을 추가하세요:\n```json\n{\n  \"mcpServers\": {\n    \"sqlite-mcp\": {\n      \"command\": \"uvx\",\n      \"args\": [\"sqlite-mcp-server\"]\n    }\n  }\n}\n```\n\n#### Claude Desktop\nClaude Desktop 설정 파일에 다음 내용을 추가하세요:\n```json\n{\n  \"mcpServers\": {\n    \"sqlite-mcp\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"tool\",\n        \"run\",\n        \"--from\",\n        \"sqlite-mcp-server\"\n      ]\n    }\n  }\n}\n```\n\n#### Claude Code\n다음 명령어를 실행하여 서버를 추가합니다:\n```bash\nclaude mcp add sqlite-mcp -- uvx…","publisher":{"name":"stevefordev","url":null},"homepage":"https://github.com/stevefordev/sqlite-mcp","repository":"https://github.com/stevefordev/sqlite-mcp","version":"0.1.7","license":null,"protocols":["mcp"],"tags":["ai","database","mcp","sqlite"],"pricing":null,"endpoints":[{"url":"pypi:sqlite-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"declared"}],"categories":["data"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"sqlite-mcp-server","registry":"pypi","observedAt":"2026-09-10T13:21:27.173Z","publishedAt":"2026-04-19T13:51:44.508261Z","latestVersion":"0.1.7"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"sqlite-mcp-server","url":"https://pypi.org/project/sqlite-mcp-server/","firstSeenAt":"2026-09-10T13:19:19.819Z","fetchedAt":"2026-09-10T13:19:19.819Z","normalizedAt":"2026-09-10T13:19:19.819Z"}]},"firstSeenAt":"2026-09-10T13:19:19.819Z","updatedAt":"2026-09-10T13:21:27.173Z"}