SQLite MCP Server

SQLite MCP 服务

此代码库包含一个用 Python 编写的 MCP（模型上下文协议）服务，可连接到包含初创公司融资数据的 SQLite 数据库。该服务将表结构作为资源公开，提供只读 SQL 查询工具，并为常见的数据分析任务提供提示词模板。它旨在与 MCP 客户端和大模型（LLM）配合使用，并通过 STDIO 协议进行通信。

目录

• 概述
• 功能
• 设置与安装
  • 创建示例 SQLite 数据库
  • 创建虚拟环境
  • 运行 MCP 服务
  • 安装到 Claude Desktop
• 使用方法
• 测试
• 日志记录
• 许可证

---

概述

该 MCP 服务使用 MCP Python SDK（包含 CLI 附加功能）实现了一个服务，它可以：

• 连接到 SQLite 数据库（例如，包含初创公司融资信息的数据库）。
• 将表结构作为 MCP 资源公开。
• 提供用于执行只读 SQL 查询的工具。
• 提供提示词模板，帮助大模型生成数据分析见解。
• 通过 STDIO 协议进行通信，从标准输入读取 JSON-RPC 消息，并向标准输出写入响应。

---

功能

• 资源

  • schema://sqlite/{table}：返回指定表的 SQL 结构。
  • schema://sqlite/all：返回包含所有表结构的 JSON 映射。

• 工具

  • sql_query：执行只读 SQL 查询。仅允许使用 SELECT 语句。

• 提示词

  • analyze_table_prompt：为指定表生成分析提示词。
  • describe_query_prompt：生成用于解释 SQL 查询的提示词。

• STDIO 协议

  • 从 stdin 读取并向 stdout 写入响应，便于集成。

• 日志记录

  • 使用 Python 的 logging 模块跟踪活动并调试错误。

---

设置与安装

创建示例 SQLite 数据库

将以下脚本保存为 create_db.py：

<same as earlier>

运行：

python create_db.py

创建虚拟环境

python -m venv venv

激活环境：

• macOS/Linux：

  source venv/bin/activate
  

• Windows：

  venv\Scripts\activate
  

安装依赖项：

pip install "mcp[cli]"

运行 MCP 服务

1. 将服务代码保存为 sqlite_mcp_server.py。
2. 运行服务：

python sqlite_mcp_server.py

可选（使用 uv）：

uv run sqlite_mcp_server.py

安装到 Claude Desktop

将以下内容保存为 install_to_claude.py 并运行：

python install_to_claude.py

使用以下内容更新 Claude Desktop 配置：

{
  "mcpServers": {
    "sqlite_mcp_server": {
      "command": "python",
      "args": ["-u", "/absolute/path/to/sqlite_mcp_server.py"]
    }
  }
}

之后重启 Claude Desktop。

---

使用方法

• 访问资源：schema://sqlite/all、schema://sqlite/startups
• 调用工具：

  SELECT * FROM startups WHERE funding_amount > 10000000;
  

• 使用提示词：生成 SQL 或解释查询。

---

测试

运行测试脚本：

python sqlite_mcp_client_tests.py sqlite_mcp_server.py

此脚本会测试：

• 列出资源
• 获取表结构
• 有效和无效的查询
• 提示词模板

---

日志记录

修改日志配置：

logging.basicConfig(
    filename='mcp_server.log',
    level=logging.DEBUG,
    format="[%(asctime)s] %(levelname)s - %(message)s",
    datefmt="%Y-%m-%d %H:%M:%S"
)

默认情况下，日志会输出到 stderr。

---

许可证

本项目采用 MIT 许可证。请参阅 LICENSE 文件。

---

附加说明

• 根据需要调整安装/配置脚本中的路径。
• 确保在运行服务之前创建 SQLite 数据库。
• 可与 MCP Inspector 或 Claude Desktop 集成。