🚀 SQLite MCP 服务器
本项目是一个基于模型上下文协议（MCP）的服务器实现，借助 SQLite 实现数据库交互与商业智能功能。它支持运行 SQL 查询、分析商业数据，还能自动生成业务见解备忘录，为商业分析提供有力支持。
🚀 快速开始
本服务器借助 SQLite 实现数据库交互和商业智能功能，支持运行 SQL 查询、分析商业数据，并自动生成业务见解备忘录。
📦 安装指南
- 若尚未安装 Bun，请先进行安装。
- 克隆此仓库。
- 安装依赖，在终端执行以下命令：
bun install - 运行设置脚本以在 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 文件。