SQLite MCP 服务器

概述

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

安装

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

   bun install
   

4. 运行设置脚本以在 Claude 桌面中配置服务器：

   bun run setup
   

设置脚本会自动将服务器配置添加到您的 Claude 桌面配置文件中，该文件位于：

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

组件

资源

该服务器公开一个动态资源：

• memo://insights：一个不断更新的商业见解备忘录，聚合了在分析过程中发现的所有见解
  • 自动更新以反映新见解的添加情况

提示

该服务器提供了一个演示提示：

• mcp-demo：引导用户进行数据库操作的交互式提示
  • 必需参数：topic（字符串）- 要分析的商业领域
  • 自动生成适当的数据库模式和样例数据
  • 引导用户完成数据分析和见解生成
  • 集成到业务见解备忘录中

工具

该服务器提供了六个核心工具：

查询工具

• read-query

  • 执行 SELECT 查询以从数据库读取数据
  • 输入：
    • query（字符串）：要执行的 SELECT SQL 查询
  • 返回：查询结果作为对象数组

• write-query

  • 执行 INSERT、UPDATE 或 DELETE 操作
  • 输入：
    • query（字符串）：SQL 修改查询
  • 返回：{ affected_rows: number }

• create-table

  • 在数据库中创建新表
  • 输入：
    • query（字符串）：CREATE TABLE SQL 语句
  • 返回：确认表已创建

模式工具

• list-tables

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

• describe-table

  • 查看特定表的模式信息
  • 输入：
    • table_name（字符串）：要描述的表名称
  • 返回：包含列定义（名称和类型）的数组

分析工具

• append-insight
  • 将新的商业见解添加到备忘录资源中
  • 输入：
    • insight（字符串）：从数据分析中发现的业务见解
  • 返回：确认见解已添加
  • 触发 memo://insights 资源更新

开发

项目结构

• src/index.ts：主服务器实现文件
• src/logger.ts：日志实用工具
• scripts/setup.ts：Claude 桌面配置脚本

日志记录

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

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

数据库

SQLite 数据库文件位于：

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

可用脚本

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

许可证

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