INSTALL.md•2.99 kB
# Installation Guide
## Prerequisites
This MCP server requires:
- **Python 3.10 or higher** (the system currently has Python 3.9.6)
- pip package manager
## Option 1: Install Python 3.10+ (Recommended)
### macOS
```bash
# Using Homebrew
brew install python@3.10
# Verify installation
python3.10 --version
```
### Windows
Download and install Python 3.10+ from [python.org](https://www.python.org/downloads/)
### Linux
```bash
# Ubuntu/Debian
sudo apt update
sudo apt install python3.10 python3.10-venv
# Fedora/RHEL
sudo dnf install python3.10
```
## Option 2: Use pyenv (Cross-platform)
```bash
# Install pyenv (if not already installed)
curl https://pyenv.run | bash
# Install Python 3.10
pyenv install 3.10.0
pyenv local 3.10.0
```
## Setup Steps
Once you have Python 3.10+:
1. **Create a virtual environment** (recommended):
```bash
cd /Users/electron/workspace/mcpdemo
python3.10 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
```
2. **Install dependencies**:
```bash
pip install -r requirements.txt
```
3. **Initialize the database**:
```bash
python -m src.seed_data
```
This will create a SQLite database with 100+ customers, 200+ trips, and 50+ requests.
4. **Test the server** (optional):
```bash
python -m src.server
```
You should see log messages indicating the server is running.
Press Ctrl+C to stop.
## Configure Claude Desktop
Add this configuration to your Claude Desktop config file:
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"travel-company": {
"command": "python3.10",
"args": ["-m", "src.server"],
"cwd": "/Users/electron/workspace/mcpdemo"
}
}
}
```
**Note**: Adjust the `command` to match your Python 3.10+ executable path. You can find it with:
```bash
which python3.10
```
If using a virtual environment, use the full path to the venv Python:
```json
{
"mcpServers": {
"travel-company": {
"command": "/Users/electron/workspace/mcpdemo/venv/bin/python",
"args": ["-m", "src.server"],
"cwd": "/Users/electron/workspace/mcpdemo"
}
}
}
```
## Troubleshooting
### "command not found: python3.10"
- Make sure Python 3.10+ is installed and in your PATH
- Try `python3 --version` to check your current version
- Use the full path to the Python executable in the config
### "No module named mcp"
- Make sure you activated the virtual environment
- Run `pip install -r requirements.txt` again
- Check that you're using Python 3.10+
### Database errors
- Delete the `data/travel_company.db` file and run `python -m src.seed_data` again
- Check that the `data/` directory exists and is writable
### Server not appearing in Claude Desktop
- Restart Claude Desktop after changing the config
- Check the Claude Desktop logs for errors
- Verify the paths in the config file are absolute paths