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：執行 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：配置服務器。
• bun run dev：以開發模式運行。
• bun run build：構建項目。
• bun run lint：檢查代碼風格。

📄 許可證

此項目的許可證遵循 MIT 協議。有關詳細信息，請參閱 LICENSE 文件。