parking-mcp-server

# Parking MCP Server A Model Context Protocol (MCP) server for parking system that provides tools to query user information, parking plans, orders, and parking space status. ## Features - 🔍 **get_user_info** - Query user basic information, parking habits, common parking lots - 📅 **get_user_parking_plans** - Query today's parking plans for a specific user - 🎫 **get_user_orders** - Query parking orders (history + current) for a user - 🅿️ **get_parking_space_status** - Query parking space occupancy status ## Installation ### Install from PyPI (Recommended) ```bash pip install parking-mcp-server ``` The package includes a sample SQLite database with parking data, so it works out-of-the-box! ### Install from Source ```bash git clone https://github.com/yourusername/parking-mcp-server.git cd parking-mcp-server pip install -e . ``` ## Prerequisites - Python 3.8+ - MCP-compatible client (Claude Desktop, Cursor, etc.) - (Optional) Your own SQLite database if you want to use custom data ## Quick Start ### 1. Install and Run (Out-of-the-Box) The package includes a sample SQLite database, so you can start immediately: ```bash # Install from PyPI pip install parking-mcp-server # Run the server (uses included sample database) parking-mcp-server # The server will automatically use the packaged parking.db ``` ### 2. Use Your Own Database (Optional) If you have your own parking database, you can use it instead: **Method A: Environment Variable** ```bash export PARKING_DB_PATH=/path/to/your/parking.db parking-mcp-server ``` **Method B: Command Line Argument** ```bash parking-mcp-server --db-path /path/to/your/parking.db ``` **Method C: Place in Current Directory** ```bash cd /path/to/your/db cp /path/to/your/parking.db . parking-mcp-server ``` ### 3. Configure MCP Client Once the server is running, configure your MCP client: **Claude Desktop:** ```json { "mcpServers": { "parking-system": { "command": "parking-mcp-server", "env": { …