SQLite MCP Server

SQLite MCP Server

概要

SQLite を通じてデータベース操作とビジネスインテリジェンス機能を提供する Model Context Protocol（MCP）サーバーの実装です。このサーバーを使用すると、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 (string)：実行する SELECT SQL クエリ
  • 戻り値：オブジェクトの配列としてのクエリ結果

• write-query

  • INSERT、UPDATE、または DELETE クエリを実行します
  • 入力：
    • query (string)：SQL 更新クエリ
  • 戻り値：{ affected_rows: number }

• create-table

  • データベースに新しいテーブルを作成します
  • 入力：
    • query (string)：CREATE TABLE SQL ステートメント
  • 戻り値：テーブル作成の確認

スキーマツール

• list-tables

  • データベース内のすべてのテーブルの一覧を取得します
  • 入力は不要です
  • 戻り値：テーブル名の配列

• describe-table

  • 指定したテーブルのスキーマ情報を表示します
  • 入力：
    • table_name (string)：説明するテーブルの名前
  • 戻り値：名前と型を含む列定義の配列

分析ツール

• append-insight
  • メモリソースに新しいビジネスインサイトを追加します
  • 入力：
    • insight (string)：データ分析から得られたビジネスインサイト
  • 戻り値：インサイト追加の確認
  • 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：Claude Desktop でサーバーを設定します
• bun run lint：ESLint チェックを実行します
• bun run lint:fix：ESLint の問題を自動的に修正します
• bun run inspect：MCP インスペクターを実行します

ライセンス

この MCP サーバーは MIT License の下でライセンスされています。詳細は LICENSE ファイルを参照してください。