QUICKSTART.md•3.15 kB
# Quick Start Guide
## TL;DR
This is a complete MCP server for a travel company that lets Claude query customer data, trip history, and information requests.
## Setup (5 minutes)
1. **Install Python 3.10+** (required - system has 3.9.6)
```bash
brew install python@3.10 # macOS
```
2. **Install and initialize**
```bash
cd /Users/electron/workspace/mcpdemo
python3.10 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python -m src.seed_data
```
3. **Configure Claude Desktop**
Edit: `~/Library/Application Support/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"travel-company": {
"command": "/Users/electron/workspace/mcpdemo/venv/bin/python",
"args": ["-m", "src.server"],
"cwd": "/Users/electron/workspace/mcpdemo"
}
}
}
```
4. **Restart Claude Desktop**
## What You Get
**6 Tools:**
- `search_customers` - Find customers by name/email/phone
- `get_customer_profile` - Get detailed customer info + stats
- `search_trips` - Find trips by destination/dates/status
- `get_trip_history` - Get all trips for a customer
- `search_requests` - Find customer inquiries
- `get_pending_requests` - Get recent pending requests
**Demo Data:**
- 100+ customers
- 200+ trips to 30+ destinations
- 50+ information requests
## Try These Queries
In Claude Desktop, ask:
```
Show me all customers named John
What trips has customer ID 5 taken?
List all pending requests from the last 7 days
Find trips to Paris in 2024
Show me customer profile for ID 10
Get all upcoming trips
Find requests for trips to Japan with high budgets
```
## File Reference
**Start here:**
- `PROJECT_SUMMARY.md` - Complete overview
- `README.md` - User documentation
- `INSTALL.md` - Detailed installation
**Technical docs:**
- `REQUIREMENTS.md` - System requirements
- `ARCHITECTURE.md` - Architecture details
**Code:**
- `src/server.py` - Main MCP server
- `src/database.py` - Database layer
- `src/tools/` - Tool implementations
- `src/seed_data.py` - Demo data generator
## Troubleshooting
**Server not showing in Claude?**
- Check Python version: `python --version` (must be 3.10+)
- Restart Claude Desktop
- Check config file path is absolute
**Module errors?**
- Activate venv: `source venv/bin/activate`
- Reinstall: `pip install -r requirements.txt`
**Database errors?**
- Delete `data/travel_company.db`
- Run: `python -m src.seed_data`
## Project Structure
```
mcpdemo/
├── src/
│ ├── server.py ← Main MCP server
│ ├── database.py ← DB layer
│ ├── seed_data.py ← Data generator
│ └── tools/ ← Tool implementations
├── data/ ← SQLite database
├── logs/ ← Server logs
└── config/ ← Configuration
```
## Next Steps
1. Read `PROJECT_SUMMARY.md` for complete overview
2. See `ARCHITECTURE.md` to understand the design
3. Check `REQUIREMENTS.md` for detailed specifications
4. Extend with new tools by following patterns in `src/tools/`
Enjoy! 🚀