SQLite MCP Server

SQLite MCP 服务

概述

一种模型上下文协议（MCP）服务实现，通过 SQLite 提供数据库交互和商业智能功能。此服务支持运行 SQL 查询、分析业务数据，并自动生成业务洞察备忘录。

安装

1. 如果尚未安装，请安装 Bun
2. 克隆此代码仓库
3. 安装依赖：

   bun install
   

4. 运行设置脚本，在 Claude Desktop 中配置此服务：

   bun run setup
   

设置脚本会自动将服务配置添加到 Claude Desktop 配置文件中，文件路径为：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

组件

资源

此服务公开一个动态资源：

• memo://insights：持续更新的业务洞察备忘录，用于汇总分析过程中发现的洞察
  • 通过 append-insight 工具发现新洞察后会自动更新

提示词

此服务提供一个演示提示词：

• mcp-demo：交互式提示词，引导用户完成数据库操作
  • 必需参数：topic - 要分析的业务领域
  • 生成适当的数据库架构和示例数据
  • 引导用户完成分析并生成洞察
  • 与业务洞察备忘录集成

工具

此服务提供六种核心工具：

查询工具

• read-query

  • 执行 SELECT 查询，从数据库读取数据
  • 输入：
    • query (string)：要执行的 SELECT SQL 查询
  • 返回：由对象组成的查询结果数组

• write-query

  • 执行 INSERT、UPDATE 或 DELETE 查询
  • 输入：
    • query (string)：SQL 修改查询
  • 返回：{ affected_rows: number }

• create-table

  • 在数据库中创建新表
  • 输入：
    • query (string)：CREATE TABLE SQL 语句
  • 返回：表创建确认信息

架构工具

• list-tables

  • 获取数据库中所有表的列表
  • 无需输入
  • 返回：表名数组

• describe-table

  • 查看特定表的架构信息
  • 输入：
    • table_name (string)：要查看的表的名称
  • 返回：包含列名和类型的列定义数组

分析工具

• append-insight
  • 向备忘录资源添加新的业务洞察
  • 输入：
    • insight (string)：通过数据分析发现的业务洞察
  • 返回：洞察添加确认信息
  • 触发 memo://insights 资源更新

开发

项目结构

• src/index.ts：服务主实现
• src/logger.ts：日志工具
• scripts/setup.ts：Claude Desktop 配置脚本

日志记录

此服务会在以下位置维护详细日志：

• server.log：位于项目根目录
• 日志包含时间戳、日志级别（DEBUG、INFO、WARN、ERROR、FATAL）和结构化元数据

数据库

SQLite 数据库文件创建于：

• data.sqlite：位于项目根目录
• 如果文件不存在，则会自动创建

可用脚本

• bun run setup：在 Claude Desktop 中配置此服务
• bun run lint：运行 ESLint 检查
• bun run lint:fix：自动修复 ESLint 问题
• bun run inspect：运行 MCP 检查器

许可证

此 MCP 服务采用 MIT 许可证。详情请参阅 LICENSE 文件。