SQLite MCP 服务器

这是一个通用的模型上下文协议（MCP）服务器，用于SQLite数据库。该服务器通过Claude Desktop和其他MCP客户端提供对database文件夹中任何SQLite数据库的读写访问。

特性

• 多数据库支持：在一个服务器上处理多个SQLite数据库
• 读操作：查询表、列出数据库、描述模式
• 写操作：安全地插入、更新和删除数据
• 安全特性：参数化查询、验证以及破坏性操作所需的WHERE子句

可用工具

数据库发现

• list_databases - 列出数据库文件夹中的所有.db文件
• list_tables - 列出特定数据库中的所有表
• describe_table - 获取详细表结构（列、类型、约束）

读操作

• query_database - 执行SELECT查询并自动限制结果数量

写操作

• insert_data - 向表中插入新行
• update_data - 更新现有行（需要WHERE子句）
• delete_data - 删除行（需要WHERE子句）
• execute_raw_sql - 执行任意SQL查询（谨慎使用）

安装

先决条件

• Python 3.10或更高版本
• pip（Python包管理器）

设置

1. 克隆或下载此仓库

2. 安装依赖项：

pip install -r requirements.txt

3. 添加您的数据库：
   • 将您的SQLite .db 文件放置在database/文件夹中
   • 服务器将与您添加到此文件夹中的任何.db文件一起工作
   • 您可以添加多个数据库并在它们之间切换

使用方法

本地运行

测试本地服务器：

python sqlite_mcp.py

Claude Desktop 集成

将服务器添加到您的Claude Desktop配置文件中：

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

方案A：直接使用Python

{
  "mcpServers": {
    "sqlite-mcp-server": {
      "command": "python",
      "args": [
        "C:/Users/YOUR_USERNAME/path/to/sqlite-mcp-server/sqlite_mcp.py"
      ]
    }
  }
}

方案B：使用uv与fastmcp

{
  "mcpServers": {
    "sqlite-mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "--with", "fastmcp",
        "fastmcp", "run",
        "C:/Users/YOUR_USERNAME/path/to/sqlite-mcp-server/sqlite_m_ mcp.py"
      ]
    }
  }
}

将C:/Users/YOUR_USERNAME/path/to/sqlite-mcp-server/替换为您实际的项目路径。

重启Claude Desktop

更新配置后：

1. 完全退出Claude Desktop
2. 重新启动应用程序
3. SQLite MCP服务器现在应该可用

在Claude中的示例用法

连接后，您可以通过Claude与您的数据库进行交互：

"列出所有可用的数据库"
"显示ecommerce.db中的表"
"描述ecommerce.db中的users表的结构"
"查询ecommerce.db中products表的前10个产品"
"向ecommerce.db插入一个新用户，姓名为'John Doe'，电子邮件为'john@example.com'"

安全注意事项

• 服务器使用参数化查询来防止SQL注入
• 写操作需要明确的WHERE子句以防止意外的大批量更新/删除
• 查询结果默认限制为1000行

项目结构

sqlite-mcp-server/
├── sqlite_mcp.py         # 主MCP服务器
├── database/             # SQLite数据库文件放在这里
│   └── *.db              # 您的数据库文件
├── requirements.txt      # Python依赖项
├── .gitignore            # Git忽略规则
└── README.md