SQLite MCP Server

SQLite MCP 服务

一个用于 SQLite 数据库的模型上下文协议（MCP）服务实现，可让 AI 模型通过标准化工具与 SQLite 数据库交互。

功能

• 查询执行：执行 SQL 查询，并内置验证和安全检查
• 架构发现：列出表并描述表架构
• 行计数：统计指定表中的行数
• 示例数据：插入示例数据以供演示（只读模式下除外）
• 自动初始化：如果不存在数据库，则创建包含产品、客户、订单和反馈的示例数据库
• 只读模式：可选择限制为只读操作，以增强安全性
• 反馈收集：提供用于收集用户反馈并将其存入数据库的工具

要求

• Python 3.8+
• requirements.txt 中列出的依赖项

安装

1. 克隆此仓库
2. 安装依赖项：

pip install -r requirements.txt

3. 配置环境变量（可选）：
   • 将 .env.example 复制为 .env（或使用现有的 .env 文件）
   • 根据需要修改设置

用法

启动服务

python server.py

服务将在 8080 端口启动（或使用 .env 文件中指定的端口）。

配置选项

通过编辑 .env 文件配置服务：

DB_PATH=sample.db         # Path to your SQLite database file
MCP_PORT=8080             # Port to run the MCP server on
READ_ONLY=true            # Set to false to allow write operations

在 Claude Desktop 中使用

将此服务添加到 Claude Desktop 配置中：

{
"mcpServers": {
		"sqlite": {
			"command": "<Path to UV>",
			"args": [
				"--directory",
				"<Absolute Path to Project Workspace>",
				"run",
				"server.py"
			]
		}
	}
}

可用工具

MCP 服务提供以下工具：

1. execute_query - 在数据库上执行 SQL 查询
2. list_tables - 列出数据库中的所有表
3. describe_table - 获取指定表的架构
4. count_rows - 统计指定表中的行数
5. insert_sample_data - 插入示例数据（只读模式下禁用）
6. add_feedback - 将用户反馈添加到反馈表中（只读模式下禁用）

示例数据库架构

示例数据库包含：

产品表

• id (INTEGER, PRIMARY KEY)
• name (TEXT, NOT NULL)
• description (TEXT)
• price (REAL, NOT NULL)
• category (TEXT)
• in_stock (BOOLEAN)

客户表

• id (INTEGER, PRIMARY KEY)
• name (TEXT, NOT NULL)
• email (TEXT, UNIQUE)
• signup_date (TEXT)

订单表

• id (INTEGER, PRIMARY KEY)
• customer_id (INTEGER, FOREIGN KEY)
• order_date (TEXT)
• total_amount (REAL)

反馈表

• id (INTEGER, PRIMARY KEY)
• user (TEXT, NOT NULL)
• email (TEXT, NOT NULL)
• feedback (TEXT, NOT NULL)
• submission_date (TEXT, DEFAULT CURRENT_TIMESTAMP)

安全注意事项

• 对 SQL 查询进行验证，以防止危险操作
• 在只读模式下，所有数据修改操作都会被阻止
• 建议在生产环境中以只读模式运行

许可证

MIT 许可证