MCP Parking Server MCP Server

MCP Parking Server

駐車場管理システム用の読み取り専用MCPサーバーです。 自然言語の質問に対して、データベースを参照し日本語で回答します。

機能

• 駐車場の検索（名前・コード・ID）
• 課金設定の取得（再課金猶予時間、夜間料金など）
• 読み取り専用SQLの実行
• スキーマコンテキストによる業務理解支援

セットアップ

1. 依存関係のインストール

pip install -e .

2. 環境変数の設定

cp .env.example .env
# .env ファイルを編集してデータベース接続情報を設定

3. データベースユーザーの作成（推奨）

-- 読み取り専用ユーザーを作成
CREATE USER 'readonly_user'@'%' IDENTIFIED BY 'secure_password';

-- SELECT権限のみを付与
GRANT SELECT ON parking_system.parkings TO 'readonly_user'@'%';
GRANT SELECT ON parking_system.parking_configs TO 'readonly_user'@'%';
GRANT SELECT ON parking_system.parking_rates TO 'readonly_user'@'%';
GRANT SELECT ON parking_system.parking_sessions TO 'readonly_user'@'%';

FLUSH PRIVILEGES;

4. サーバーの起動

mcp-parking-server

MCP クライアントからの接続

Claude Desktop での設定例

claude_desktop_config.json:

{
  "mcpServers": {
    "parking": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "/path/to/mcp-parking-server",
      "env": {
        "DB_HOST": "localhost",
        "DB_PORT": "3306",
        "DB_USER": "readonly_user",
        "DB_PASSWORD": "secure_password",
        "DB_NAME": "parking_system"
      }
    }
  }
}

ツール一覧

プロジェクト構造

mcp-parking-server/
├── src/
│   ├── __init__.py
│   ├── server.py          # MCPサーバー本体
│   ├── database.py        # データベース接続
│   ├── schema_context.py  # スキーマコンテキスト管理
│   ├── sql_validator.py   # SQLバリデーション
│   └── tools.py           # ツール定義
├── config/
│   └── schema_context.json # スキーマ定義
├── docs/
│   └── examples.md        # 使用例
├── .env.example
├── pyproject.toml
└── README.md

セキュリティ

詳細は下記「セキュリティガードレール」セクションを参照してください。

セキュリティガードレール

このMCPサーバーは、エンタープライズ環境での安全な運用を前提に設計されています。

1. 多層防御アーキテクチャ

┌─────────────────────────────────────────────────────────┐
│                    MCP Client (Claude)                  │
└─────────────────────────────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────┐
│  Layer 1: ツールレベル制限                               │
│  - 事前定義されたツールのみ使用可能                       │
│  - 入力パラメータのバリデーション                        │
└─────────────────────────────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────┐
│  Layer 2: SQLバリデーション (sql_validator.py)          │
│  - SELECT文のみ許可                                      │
│  - 禁止キーワード・関数のブロック                        │
│  - テーブルホワイトリスト                                │
│  - LIMIT強制                                             │
└─────────────────────────────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────┐
│  Layer 3: データベース接続 (database.py)                │
│  - 読み取り専用トランザクション                          │
│  - クエリタイムアウト                                    │
│  - 接続プール制限                                        │
└─────────────────────────────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────┐
│  Layer 4: データベースユーザー権限                       │
│  - SELECT権限のみ付与                                    │
│  - 対象テーブル限定                                      │
└─────────────────────────────────────────────────────────┘

2. SQLバリデーション詳細

2.1 禁止キーワード

以下のキーワードを含むクエリは拒否されます：

2.2 禁止関数

SQLインジェクション対策として、以下の関数を禁止：

• SLEEP() - 時間ベース攻撃
• BENCHMARK() - 時間ベース攻撃
• LOAD_FILE() - ファイル読み取り

2.3 テーブルホワイトリスト

アクセス可能なテーブルを明示的に制限：

ALLOWED_TABLES = [
    "parkings",
    "parking_configs",
    "parking_rates",
    "parking_sessions",
]

2.4 その他の制限

3. データベースレベルの保護

3.1 読み取り専用トランザクション

# 接続時に読み取り専用モードを設定
await cursor.execute("SET SESSION TRANSACTION READ ONLY")

3.2 タイムアウト制御

# クエリタイムアウト（デフォルト30秒）
await asyncio.wait_for(
    cursor.execute(query, params),
    timeout=self.config.query_timeout
)

3.3 接続プール制限

# 同時接続数を制限
pool_min_size=1
pool_max_size=5

4.