SQLite MCP サーバー

概要

SQLite を介してデータベースとの連携とビジネスインテリジェンス機能を提供する、モデルコンテキストプロトコル (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 : 分析中に発見された洞察を集約した、継続的に更新されるビジネス洞察メモ
  • 追加インサイトツールで新しいインサイトが発見されると自動更新されます

プロンプト

サーバーはデモプロンプトを提供します:

• 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 Desktopでサーバーを構成する
• bun run lint : ESLintチェックを実行する
• bun run lint:fix : ESLintの問題を自動的に修正する
• bun run inspect : MCPインスペクタを実行する

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。詳細はLICENSEファイルをご覧ください。