db-mcp

読み取り専用の MCP サーバーです。AI エージェントに、小規模な SQLite ショップデータベース（shop.db）への安全なアクセスを提供します。スキーマ探索、自由形式の読み取り専用 SQL、あらかじめ用意された分析レポートを備えています。

インストール

npm install

Related MCP server: SQLite Read-Only MCP Server

設定

サーバーは、プロセス環境変数 SHOP_DB_PATH を読み取ってデータベースファイルの場所を特定します。この変数は省略可能です。未設定の場合は、サーバーはプロジェクトルートの shop.db を使用します。.env ファイルは自動的に読み込まれません（dotenv への依存はなく、package.json のスクリプトにも --env-file フラグはありません）。.env.example は、変数名を思い出すためのリマインダーとしてのみ提供されています。SHOP_DB_PATH は、サーバーが実際に実行される環境に設定してください。stdio MCP クライアントの場合は、そのクライアント設定内の env キーに指定します（下記の「クライアントを接続する」を参照）。

ビルド

npm run build

実行

npm start
# or directly:
node dist/index.js

サーバーは stdio 上で MCP 通信を行います。つまり、対話的に実行されるのではなく、MCP クライアント/ホストの子プロセスとして起動されることを想定しています。

クライアントを接続する

一般的な stdio MCP クライアント設定:

{
  "mcpServers": {
    "db-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/db-mcp/dist/index.js"],
      "env": { "SHOP_DB_PATH": "/absolute/path/to/shop.db" }
    }
  }
}

Claude Desktop: claude_desktop_config.json の mcpServers に同じブロックを追加し（OS ごとの設定ファイルの場所は MCP.md を参照）、その後 Claude Desktop を再起動します。

ツール

セキュリティに関する注意

• データベース接続は { readonly: true, fileMustExist: true } で開かれます。SQLite エンジン自体が、送信される SQL の内容に関係なく、物理的にすべての書き込みを拒否します。

• query ツールは、入力がデータベースに到達する前に、それが単一の SELECT（または WITH ... SELECT）ステートメントであることをさらに検証し、INSERT/UPDATE/DELETE/DROP/ALTER/CREATE/PRAGMA/ATTACH/DETACH/REPLACE/VACUUM/REINDEX/TRIGGER およびマルチステートメントの入力を、わかりやすいエラーメッセージとともに拒否します。

• エラーは各ツールの境界で捕捉され、isError: true と短いメッセージを持つ MCP ツールの結果として返されます。スタックトレースやファイルシステムのパスがクライアントに送信されることは一切ありません。

• すべてのログは stderr（console.error）に送信されます。stdout は JSON-RPC プロトコルストリーム専用に予約されています。

テスト

npm test

node --test（tsx 経由）をすべての *.test.ts ファイルで実行します。実物の shop.db に対する SQL ガード、DB 接続、各ツールのクエリロジックのユニットテストに加え、コンパイル済みサーバーを起動して stdio 上の実際の MCP クライアントで操作するエンドツーエンドテストが含まれます。

Docker

docker build -t db-mcp .
docker run -i db-mcp

サーバーをローカルで実行するために必須ではありません（上記のクライアント設定はローカルの node プロセスを想定しています）が、検証や実行のための代替手段として提供されています。