Mcp Sqlite Bun Server

Mcp Sqlite Bun Server

🚀 SQLite MCP 服务器

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

🚀 快速开始

本服务器基于模型上下文协议(MCP),借助SQLite实现数据库交互与商业智能功能。你可以运行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:执行 INSERTUPDATEDELETE 查询。

    • 输入:
      • 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:位于项目根目录中。
  • 日志包含时间戳、日志级别(DEBUGINFOWARNERRORFATAL)和结构化元数据。

数据库

SQLite 数据库文件位置为:

  • data.sqlite:位于项目根目录中。若不存在,将自动创建。

可用脚本

  • bun run setup:配置服务器。
  • bun run dev:以开发模式运行。
  • bun run build:构建项目。
  • bun run lint:检查代码风格。

📄 许可证

此项目的许可证遵循 MIT 协议。有关详细信息,请参阅 LICENSE 文件。

  • 0 关注
  • 0 收藏,11 浏览
  • system 提出于 2025-09-24 14:45

相似服务问题