読み取り専用 MCP ストアサーバー

Python MCP サーバー（stdio 経由）で、既存のオンラインストア SQLite データベース（data/shop.db）を読み取ります。ファイルは読み取り専用で開かれ、変更を伴う SQL は拒否され、実行されません。

インストール

Python 3.11 以上:

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

Related MCP server: sqlite-mcp-local

起動

プロジェクトのルートから（データベースへのパスはデフォルトで ./data/shop.db）:

python -m shop_mcp
# или
shop-mcp

別のデータベースパス:

SHOP_DB_PATH=~/my/test-mcp-db/data/shop.db python -m shop_mcp

このプロセスは MCP 経由で stdin/stdout を介して通信します。MCP クライアントが接続されるまで、このターミナルにコマンドを入力しないでください。

Cursor での MCP 設定

mcpServers エントリを追加します（Cursor Settings → MCP、またはプロジェクト内の .cursor/mcp.json）。トランスポートは stdio です。

例の中のパス ~/my/test-mcp-db は、このリポジトリを指しています。サーバーは SHOP_DB_PATH を自身で展開します（~ → ホームディレクトリ）。Cursor が command / cwd で ~ を展開しない場合は、そこに /Users/<вы>/my/test-mcp-db/... を指定してください。

ローカル (venv)

{
  "mcpServers": {
    "shop": {
      "command": "~/my/test-mcp-db/.venv/bin/python",
      "args": ["-m", "shop_mcp"],
      "cwd": "~/my/test-mcp-db",
      "env": {
        "SHOP_DB_PATH": "~/my/test-mcp-db/data/shop.db"
      }
    }
  }
}

pip install -e . の後、コンソールスクリプトの方が便利な場合:

{
  "mcpServers": {
    "shop": {
      "command": "~/my/test-mcp-db/.venv/bin/shop-mcp",
      "cwd": "~/my/test-mcp-db",
      "env": {
        "SHOP_DB_PATH": "~/my/test-mcp-db/data/shop.db"
      }
    }
  }
}

Docker

イメージを一度ビルドします:

docker build -t shop-mcp .

{
  "mcpServers": {
    "shop": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "~/my/test-mcp-db/data/shop.db:/data/shop.db:ro",
        "-e",
        "SHOP_DB_PATH=/data/shop.db",
        "shop-mcp"
      ]
    }
  }
}

-i フラグは stdin io を接続したままにするために必須です。shop.db のみをマウントしてください。コンテナがホスト上のファイルを上書きしないようにしてください。

ツール

合計、数量、売上は order_items.quantity * order_items.unit_price として計算され、ステータスが cancelled の注文は除外されます。暦年は strftime('%Y',orders.order_date) から取得されます。

セキュリティ

• SQLite URI file:<abs>?mode=ro

• コメントは除去され、クエリチェーン（SELECT 1; DELETE ...）は拒否されます

• INSERT / UPDATE / DELETE / DROP / ALTER / CREATE / ATTACH / PRAGMA / … → 明示的な「許可されていません」エラー

• SQLite の構文エラーと不明なカラムは、構造化して返されます。プロセスは終了しません

評価に関する注記

• customers には country カラムがありません。 これは describe_table で確認できます。地理情報を勝手に推定してはいけません。SELECT country FROM customers は SQLite エラーを返します。

• 現在のダンプの注文日は 2026 年です。 2025 年の売上は 0 になることがあります。これはフィルターの故障ではなく、正しい結果です。

テスト

pytest

テストは、data/shop.db を一時ファイルにコピーし、拒否された書き込み後もコピーのハッシュが変更されないことを検証します。

実行済みクエリの例