SQLite MCP 服务器

概述

这是一个通过 SQLite 提供数据库交互和商业智能功能的模型上下文协议 (MCP) 服务器实现。该服务器能够运行 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 (字符串): 要执行的 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 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 文件。