MCP SQLite Server

MCP SQLite Server

MCP SQLite Server 是一个基于 Go 的 MCP 服务实现，用于封装 SQLite 数据库，让 MCP 客户端（例如 Claude Desktop）能够通过标准化的 JSON‑RPC 协议与 SQLite 交互。

功能

• 符合 MCP 规范： 根据 MCP 规范提供基于 JSON‑RPC 的工具执行接口。
• SQLite 操作： 支持创建表、描述表结构、列出表，以及执行读写查询等操作。

要求

• Docker（推荐）

本地开发所需：

• Go 1.24 或更高版本
• SQLite（如果数据库文件不存在，将自动创建）
• GCC 和开发工具（用于 CGO 编译）

使用 Docker（推荐）

docker pull cnosuke/mcp-sqlite:latest

# Run with default SQLite database
docker run -i --rm cnosuke/mcp-sqlite:latest

# Run with a mounted SQLite database
docker run -i --rm -v /path/to/your/db:/app/sqlite.db cnosuke/mcp-sqlite:latest

与 Claude Desktop 配合使用（Docker）

要通过 Docker 与 Claude Desktop 集成，请在 claude_desktop_config.json 文件中添加一项：

{
  "mcpServers": {
    "sqlite": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "cnosuke/mcp-sqlite:latest"]
    }
  }
}

要通过卷挂载实现持久化存储：

{
  "mcpServers": {
    "sqlite": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-v", "/path/to/your/db:/app/sqlite.db", "cnosuke/mcp-sqlite:latest"]
    }
  }
}

构建和运行（Go 二进制文件）

或者，你也可以直接构建并运行 Go 二进制文件：

# Build the server
make bin/mcp-sqlite

# Run the server
./bin/mcp-sqlite server --config=config.yml

与 Claude Desktop 配合使用（Go 二进制文件）

要通过 Go 二进制文件与 Claude Desktop 集成，请在 claude_desktop_config.json 文件中添加一项：

{
  "mcpServers": {
    "sqlite": {
      "command": "./bin/mcp-sqlite",
      "args": ["server", "--config", "config.yml"],
      "env": {
        "LOG_PATH": "",
        "SQLITE_PATH": "/path/to/your/sqlite.db"
      }
    }
  }
}

此配置会在 Claude Desktop 中注册 MCP SQLite Server。将 LOG_PATH 设为空字符串后，服务只会输出致命错误，从而确保非关键日志不会干扰通过 stdio 传输的 MCP 协议消息。

配置

服务通过 YAML 文件进行配置（默认值：config.yml）。例如：

log: 'mcp-sqlite.log'
debug: false

sqlite:
  path: './sqlite.db'

也可以通过环境变量指定配置选项：

• LOG_PATH：日志文件路径（空字符串会禁用文件日志）
• DEBUG：启用调试日志（true/false）
• SQLITE_PATH：SQLite 数据库文件路径

日志记录

日志会写入 log 配置选项或 LOG_PATH 环境变量指定的文件。当此值为空时，只会将致命错误输出到 stderr，其他所有日志都会被抑制。

重要提示： 使用 stdio 传输方式运行 MCP 服务时，不得将日志输出到标准输出，否则会干扰 MCP 协议通信。对于 Claude Desktop，建议将 LOG_PATH 设为空字符串。

Docker 提示： Docker 镜像默认禁用文件日志，因为容器日志通常从 stdout/stderr 收集。

MCP 服务用法

MCP 客户端通过向服务发送 JSON‑RPC 请求来执行各种工具。支持以下 MCP 工具：

• create_table： 执行 CREATE TABLE 语句。
• describe_table： 获取指定表的结构详情。
• list_tables： 返回 SQLite 数据库中的所有表。
• read_query： 执行 SELECT 查询，并以 JSON 格式返回结果。
• write_query： 执行写入查询（例如 INSERT、UPDATE 或 DELETE）。

命令行参数

启动服务时，可以指定各种设置：

./bin/mcp-sqlite server [options]

选项：

• --config、-c：配置文件路径（默认值为 "config.yml"）。

贡献

欢迎贡献！请 fork 此仓库，并提交拉取请求，以改进项目或修复错误。对于重大更改，请先创建 issue，讨论你的想法。

许可证

本项目采用 MIT License 许可。

作者： cnosuke（x.com/cnosuke）