SQLite MCP服务器
概述
一种模型上下文协议(MCP)服务器实现,通过SQLite提供数据库交互和商业智能功能。此服务器支持运行SQL查询、分析业务数据和自动生成业务洞察备忘录。
安装
- 安装 包子 如果你还没有
- 克隆此存储库
- 安装依赖项:
bun install- 运行安装脚本以在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文件。
