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ファイルをご覧ください。