git clone https://github.com/yunosuke-github/secure-mcp-database-crud.git
cd secure-mcp-database-crud
cp .env.example .env
uv sync
uv run mcp-db-init
uv run mcp-database-crud

{
  "mcpServers": {
    "secure-task-database": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/secure-mcp-database-crud",
        "run",
        "mcp-database-crud"
      ]
    }
  }
}

uv run pytest

cp .env.example .env
# .env の DATABASE_BACKEND を mysql へ変更
docker compose up -d --wait mysql
uv run mcp-database-crud

RUN_MYSQL_TESTS=1 uv run pytest -m mysql
docker compose down

flowchart LR
    U[ユーザー] --> C[AIクライアント]
    C -->|Tool名と構造化引数| M[MCPサーバー]
    M --> V[Pydantic検証]
    V --> R[TaskRepository]
    R -->|固定SQLとバインド値| D[(SQLite / MySQL)]
    M -.->|SQL・認証情報は返さない| C

src/mcp_database_crud/
├── config.py                    # 環境変数とSecretStr設定
├── confirmation.py              # HMAC確認トークン
├── models.py                    # Toolの入力・出力Schema
├── server.py                    # FastMCPの組み立てとstdio起動
├── database/
│   ├── protocol.py              # SQLite/MySQL共通契約
│   ├── sqlite_repository.py     # 呼び出し単位の接続とトランザクション
│   ├── mysql_repository.py      # reader/writer接続プール
│   └── sqlite_schema.sql
└── tools/
    ├── handlers.py              # 安全な結果とエラー変換
    ├── read_tools.py            # 読み取りTool登録
    └── write_tools.py           # 更新・削除Tool登録
docker/mysql/init/001_schema.sql # MySQLスキーマと最小権限GRANT
tests/                            # セキュリティ特性とRepository契約

python -c 'import secrets; print(secrets.token_urlsafe(48))'

uv run ruff format --check .
uv run ruff check .
uv run mypy
uv run pytest --cov=mcp_database_crud --cov-report=term-missing