Jacksteamdev MCP Sqlite Bun Server

🚀 SQLite MCP 服務器

本項目是一個基於模型上下文協議（MCP）的服務器實現，藉助 SQLite 實現數據庫交互與商業智能功能。它支持運行 SQL 查詢、分析商業數據，還能自動生成業務見解備忘錄，為商業分析提供有力支持。

🚀 快速開始

本服務器藉助 SQLite 實現數據庫交互和商業智能功能，支持運行 SQL 查詢、分析商業數據，並自動生成業務見解備忘錄。

📦 安裝指南

1. 若尚未安裝 Bun，請先進行安裝。
2. 克隆此倉庫。
3. 安裝依賴，在終端執行以下命令：

   bun install
   

4. 運行設置腳本以在 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 文件。