商店的只读 MCP 服务器

用于现有在线商店 SQLite 数据库（data/shop.db）的 Python MCP 服务器，通过 stdio 运行。该文件仅以只读方式打开；任何修改类 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 标志是必需的，以便保持 stdio 连接。请只挂载 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 复制到临时文件，并验证在拒绝写入后副本的哈希没有变化。

已处理请求示例