Skip to main content
Glama
m-umemura-pitdesign

MCP Parking Server

by m-umemura-pitdesign
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

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" } } } }

ツール一覧

ツール名

説明

search_parking

駐車場を検索（名前・コード・ID）

get_parking_config

駐車場の設定を取得

get_night_rate_config

夜間料金設定を取得

execute_readonly_sql

読み取り専用SQLを実行

get_schema_context

スキーマの業務コンテキストを取得

explain_term

業務用語を説明

suggest_approach

クエリアプローチを提案

プロジェクト構造

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 禁止キーワード

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

カテゴリ

禁止キーワード

DML（データ変更）

INSERT, UPDATE, DELETE, REPLACE, TRUNCATE, MERGE

DDL（スキーマ変更）

CREATE, ALTER, DROP, RENAME

DCL（権限管理）

GRANT, REVOKE

トランザクション

COMMIT, ROLLBACK, SAVEPOINT

その他

LOAD, HANDLER, CALL, EXECUTE, PREPARE

ファイル操作

INTO OUTFILE, INTO DUMPFILE, LOAD_FILE

2.2 禁止関数

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

  • SLEEP() - 時間ベース攻撃

  • BENCHMARK() - 時間ベース攻撃

  • LOAD_FILE() - ファイル読み取り

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

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

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

2.4 その他の制限

制限項目

内容

複文実行

セミコロンによる複数SQL実行を禁止

コメント

--, /**/, # を禁止

UNION

UNIONインジェクション対策として禁止

サブクエリ

最大1階層まで

LIMIT

必須（自動付与）、最大1000件

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. 推奨されるデータベース設定

4.1 専用の読み取り専用ユーザー

-- 最小権限の原則に従ったユーザー作成 CREATE USER 'mcp_readonly'@'%' IDENTIFIED BY 'strong_password'; -- 必要なテーブルにのみSELECT権限を付与 GRANT SELECT ON parking_system.parkings TO 'mcp_readonly'@'%'; GRANT SELECT ON parking_system.parking_configs TO 'mcp_readonly'@'%'; GRANT SELECT ON parking_system.parking_rates TO 'mcp_readonly'@'%'; GRANT SELECT ON parking_system.parking_sessions TO 'mcp_readonly'@'%'; -- 権限を反映 FLUSH PRIVILEGES;

4.2 リードレプリカの使用（推奨）

本番環境では、リードレプリカに接続することを推奨します：

DB_HOST=replica.parking-db.internal

5. 監査とログ

5.1 アプリケーションログ

# 全てのツール呼び出しをログ記録 logger.info(f"Tool called: {name} with args: {arguments}")

5.2 推奨される追加対策

  • クエリログの永続化（CloudWatch Logs等）

  • 異常なクエリパターンのアラート設定

  • 定期的なアクセスログレビュー

6. プライバシー保護

6.1 個人情報の取り扱い

parking_sessions.vehicle_number（車両番号）は個人情報に該当する可能性があります。 スキーマコンテキストでこれを明示し、不必要なアクセスを抑制します：

{ "privacy_note": "vehicle_number は個人情報に該当する可能性があるため、必要最小限の参照に留める" }

6.2 データマスキング（オプション）

必要に応じて、機密カラムのマスキングを実装できます：

-- マスキングの例 SELECT id, CONCAT(LEFT(vehicle_number, 2), '****') as vehicle_number_masked FROM parking_sessions

7. 障害対策

障害シナリオ

対策

DB接続失敗

明確なエラーメッセージを返却

クエリタイムアウト

30秒でタイムアウト、エラー返却

不正なSQL

バリデーションエラーを返却

大量データ

LIMITによる件数制限

8. セキュリティチェックリスト

デプロイ前に以下を確認してください：

  • データベースユーザーはSELECT権限のみ持っている

  • 環境変数でパスワードを管理している（ハードコードしていない）

  • リードレプリカまたは専用の参照用DBに接続している

  • ネットワークアクセスが制限されている（VPC内など）

  • アプリケーションログが有効になっている

  • schema_context.json のテーブル一覧が実際のホワイトリストと一致している

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/m-umemura-pitdesign/pit-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server