SQLite数据库智能分析服务

SQLite MCP服务器

概述

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

安装

1. 安装 包子 如果你还没有
2. 克隆此存储库
3. 安装依赖项：
   复制

   bun install
   

4. 运行安装脚本以在Claude Desktop中配置服务器：
   复制

   bun run setup
   

安装脚本将自动将服务器配置添加到您的Claude Desktop配置文件中，该文件位于：

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

组件

资源

服务器公开单个动态资源：

• memo://insights：一份不断更新的业务见解备忘录，汇总了分析过程中发现的见解
  • 通过附加洞察工具发现新洞察时自动更新

提示

服务器提供演示提示：

• 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桌面配置脚本

日志记录

服务器在以下位置维护详细的日志：

• server.log：位于项目根目录中
• 日志包括时间戳、日志级别（调试、信息、警告、错误、致命）和结构化元数据

数据库

SQLite数据库文件创建于：

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

可用脚本

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

许可证

此MCP服务器根据MIT许可证获得许可。有关详细信息，请参阅LICENSE文件。