SQLite MCP Server

SQLite MCP サーバー

SQLite データベースとやり取りするための、TypeScript を使用した Model Context Protocol（MCP）サーバーの実装です。このサーバーは、拡張可能なプロトコルフレームワーク内で、SQL クエリの実行、データベーススキーマの管理、ビジネスインサイトの生成を行うための対話型インターフェースを提供します。

MCP に馴染みがありませんか？以下の「MCP とは？」セクションをご覧ください。

機能

コマンド	説明	例
list_tables	SQLite データベースのすべてのテーブルを一覧表示します	-
read_query	SQLite データベースで SELECT クエリを実行します	SELECT * FROM users WHERE age > 18

インストールとセットアップ

git clone https://github.com/javsanmar5/mcp-server.sqlite.git
cd mcp-server.sqlite

まだ npm パッケージとして公開されていないため、ここでは Docker を使用したインストール方法を説明します。

1. Docker イメージをビルドする

docker build -t mcp/sqlite .

2. AI クライアントを設定する

以下を AI クライアントの設定ファイルに追加してください。

"mcpServers": {
  "sqlite": {
    "command": "docker",
    "args": [
      "run",
      "--rm",
      "-i",
      "-v",
      "mcp-test:/mcp",
      "mcp/sqlite",
      "--db-path",
      "test_db.sqlite3"
    ]
  }
}

その JSON ファイルがどれかわからない場合は、クライアント設定ガイドをご覧ください。

3. AI クライアントを再起動する

再起動後、AI クライアントのインターフェースで MCP ツールを利用できるようになります。 Windows では、変更を反映するためにプロセスを手動で終了する必要がある場合があります。

ドキュメント

MCP とは？

Model Context Protocol（MCP）は、AI モデルが外部のツールやサービスとやり取りするための標準化された方法です。定義されたプロトコルインターフェースを通じて、データベースクエリの実行、外部 API へのアクセス、ファイルの操作などを AI アシスタントが行えるようにします。

MCP は、AI モデル自体への直接的な統合を必要とせず、ツールやデータソースへの構造化されたアクセスを提供することで、会話の枠を超えて AI の機能を拡張します。

チュートリアル：Claude Desktop のセットアップ

Claude Desktop は、MCP サーバーをサポートする数多くの AI クライアントの 1 つです。Windows でのセットアップ方法は次のとおりです。

1. Windows Key + R を押して「ファイル名を指定して実行」ダイアログを開きます
2. %appdata%\Claude と入力して Enter キーを押します
3. claude_desktop_config.json がまだ存在しない場合は、新しいファイルを作成します
4. 上記のセットアップ手順のステップ 2 にある設定を追加します
5. ファイルを保存して Claude Desktop を再起動します
6. Claude のインターフェースで SQLite ツールを利用できるようになります

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。

コントリビューション

このプロジェクトは主に学習目的で作成されました。ただし、コントリビューションをご希望の場合は、お気軽にプルリクエストを送信してください。内容を確認します。

ご関心をお寄せいただき、ありがとうございます！