MCP Sqlite Bun Server

🚀 SQLite MCP サーバー

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

🚀 クイックスタート

SQLite MCPサーバーを使用することで、データベース操作やビジネスデータ分析を行い、自動的にビジネス洞察メモを生成できます。

✨ 主な機能

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

ツール

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