Jacksteamdev MCP Sqlite Bun Server

🚀 SQLite MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）に基づいて構築され、SQLite を通じてデータベースとのインタラクションやビジネスインテリジェンス機能を提供します。SQL クエリの実行、ビジネスデータの分析、そして自動的なビジネス洞察メモの生成をサポートしています。

🚀 クイックスタート

このサーバーを使用することで、SQLite データベースとのやり取りを通じて、ビジネスデータを分析し、自動的にビジネス洞察を生成することができます。

📦 インストール

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（文字列）- 分析するビジネス分野
  • 適切なデータベーススキーマとサンプルデータを自動生成します。
  • ユーザーをデータ分析と洞察生成のプロセスに導きます。
  • ビジネス洞察メモに統合されます。

ツール

このサーバーは、6 つの核心的なツールを提供しています：

クエリツール

• 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 ファイルを参照してください。