Provides comprehensive SQLite database management capabilities including executing SQL queries, performing CRUD operations, creating tables, and managing database schemas with built-in SQL injection protection.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SQLite MCP Servershow me all customers who made purchases in the last 30 days"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
SQLite MCP Server
通用SQLite数据库管理工具,通过MCP协议提供SQL执行能力。
功能特性
执行任意合法的SQL查询
支持SELECT/INSERT/UPDATE/DELETE/CREATE等操作
内置SQL注入防护
支持stdio、SSE和streamable-http三种通信模式
可配置的IP和端口
快速开始
安装依赖
pip install -r requirements.txtSQLite3 是Python内置模块,无需单独安装。
启动服务器
# 默认配置
python app/main.py
# 自定义配置
# stdio模式
python app/main.py --server_type stdio
# sse模式
python app/main.py --server_type sse --host 0.0.0.0 --port 8000
# streamable-http模式 (注意使用短横线)
python app/main.py --server_type streamable-http --host 127.0.0.1 --port 8080客户端调用示例
使用提供的客户端类
# 导入客户端类
from client import SQLiteMCPClient
# 创建客户端实例 (默认使用SSE模式)
client = SQLiteMCPClient(server_type="sse", host="localhost", port=8000)
# 创建表
result = client.execute_sql("""
CREATE TABLE IF NOT EXISTS users (
id INTEGER PRIMARY KEY,
name TEXT NOT NULL,
email TEXT UNIQUE,
age INTEGER
)
""")
# 插入数据 (使用参数化查询防止SQL注入)
result = client.execute_sql(
"INSERT INTO users (name, email, age) VALUES (?, ?, ?)",
["张三", "zhangsan@example.com", 30]
)
# 查询数据
result = client.execute_sql("SELECT * FROM users")
print(result)
# 关闭客户端
client.close()直接调用MCP工具
# 查询数据
execute_sql({
"query": "SELECT * FROM table WHERE condition"
})
# 插入数据 (带参数)
execute_sql({
"query": "INSERT INTO table (col1, col2) VALUES (?, ?)",
"parameters": ["value1", "value2"]
})
# 创建表
execute_sql({
"query": "CREATE TABLE IF NOT EXISTS table (id INTEGER PRIMARY KEY, name TEXT)"
})配置与启动
启动参数
参数 | 默认值 | 描述 |
--server_type | sse | 服务器类型: stdio/sse/streamable-http |
--host | 0.0.0.0 | 监听地址 |
--port | 8000 | 监听端口 |
--log_level | INFO | 日志级别: DEBUG/INFO/WARNING/ERROR |
环境变量配置
环境变量 | 默认值 | 描述 |
MCP_HOST | 0.0.0.0 | 监听地址 |
MCP_PORT | 8000 | 监听端口 |
MCP_SERVER_TYPE | sse | 服务器类型 (sse/stdio/streamable-http) |
数据库自动创建
服务启动时会自动在项目根目录创建demo.db数据库文件(如果不存在)
启动示例
# SSE模式 (默认)
python app/main.py --server_type sse --port 8000
# stdio模式
python app/main.py --server_type stdio
# streamable-http模式 (注意使用短横线)
python app/main.py --server_type streamable-http --port 8080
# 带调试日志
python app/main.py --log_level DEBUGJSON配置示例
stdio模式配置
{
"mcpServers": {
"sqlite-mcp": {
"command": "python",
"args": ["app/main.py", "--server_type", "stdio"]
}
}
}sse模式配置
{
"mcpServers": {
"sqlite-mcp": {
"type": "sse",
"url": "http://localhost:8000/sse",
"port": 8000
}
}
}streamable-http模式配置
{
"mcpServers": {
"sqlite-mcp": {
"type": "streamableHttp",
"url": "http://localhost:8000/mcp",
"port": 8000,
"headers": {
"Content-Type": "application/json"
}
}
}
}项目结构
SQLite-MCP-Server/
├── app/ # 主应用代码
│ ├── main.py # 主入口
│ ├── config.py # 配置管理
│ ├── database.py # 数据库连接
│ ├── models/ # 数据模型
│ │ ├── __init__.py
│ │ └── sql_utils.py # SQL工具类
│ └── tools/ # MCP工具
│ ├── __init__.py
│ └── crud.py # SQL执行工具
├── client.py # 客户端示例
├── README.md # 项目文档
├── requirements.txt # 依赖列表
└── demo.db # 自动创建的SQLite数据库文件