SQLite MCP 服务器

概述

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

<a href="https://glama.ai/mcp/servers/le7p83s38c"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=3425962750,2135162311&fm=3081&app=3081&f=PNG?w=760&h=400" alt="SQLite Server MCP 服务器" /> </a>

安装

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 (字符串): 要执行的 SELECT SQL 查询
  • 返回：作为对象数组的查询结果

• write-query

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

• 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 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 文件。