# Quick Start - MCP Server Setup
## Your Server is Working! ✅
The "error" you saw when running `python server.py` is actually NORMAL. The server was waiting for input from an MCP client.
## How to Actually Use It
### Step 1: Configure Claude Desktop
Run this in PowerShell:
```powershell
# Create Claude config
$claudeConfigDir = "$env:APPDATA\Claude"
if (-not (Test-Path $claudeConfigDir)) {
New-Item -ItemType Directory -Path $claudeConfigDir -Force
}
$configPath = "$claudeConfigDir\claude_desktop_config.json"
$config = @{
mcpServers = @{
moviesda = @{
command = "python"
args = @("C:\Users\Daniel\Documents\tamilrockersMcp\server.py")
}
}
} | ConvertTo-Json -Depth 10
Set-Content -Path $configPath -Value $config
Write-Host "✅ Config created at: $configPath"
```
### Step 2: Test Database (Optional)
```powershell
cd C:\Users\Daniel\Documents\tamilrockersMcp
python test_db.py
```
You should see:
```
🔍 Testing Moviesda MCP Server Database
1. Initializing database...
✅ Database initialized
2. Adding sample movies...
✅ Added: The Raja Saab (2026)
✅ Added: Parasakthi (2026)
...
```
### Step 3: Restart Claude Desktop
1. **Completely close Claude** (exit from system tray)
2. **Reopen Claude Desktop**
### Step 4: Use the Tools in Claude
In a new conversation with Claude, try these:
**Example 1: Update Database**
```
Update the moviesda database with latest movies
```
**Example 2: Search for a Movie**
```
Search for "Raja Saab" in the moviesda database
```
**Example 3: Add a Movie**
```
Add "My Movie" (2026) to moviesda database with URL /my-movie-2026/
```
---
## Verifying It Works
### Check if Tools are Available
In Claude Desktop:
1. Look for a **🔌 tool/plug icon** near the message input
2. Click it
3. You should see three tools:
- `search_movie`
- `add_movie`
- `update_movies`
If you see these tools, **it's working!** 🎉
### If Tools Don't Appear
1. **Check config file exists**:
```powershell
Get-Content "$env:APPDATA\Claude\claude_desktop_config.json"
```
2. **Verify Python works**:
```powershell
python --version
python -c "import mcp, httpx, bs4; print('All packages installed!')"
```
3. **Restart Claude Desktop again**
---
## Understanding MCP Server Errors
### ❌ ERROR: This is a problem
```
ModuleNotFoundError: No module named 'mcp'
```
**Fix**: `pip install mcp httpx beautifulsoup4`
### ✅ NOT AN ERROR: This is normal
```
KeyboardInterrupt
(when you press Ctrl+C after running python server.py)
```
**This is expected** - the server was waiting for input
---
## Common Issues
### Issue: "python not recognized"
```powershell
# Verify installation
python --version
# If missing, install via winget
winget install Python.Python.3.12
```
### Issue: Tools not showing in Claude
1. Config file must be exactly: `C:\Users\Daniel\AppData\Roaming\Claude\claude_desktop_config.json`
2. File path in config must match: `C:\Users\Daniel\Documents\tamilrockersMcp\server.py`
3. Must restart Claude Desktop after config changes
### Issue: "Module not found" when Claude calls tools
```powershell
# Install dependencies
pip install mcp httpx beautifulsoup4
# Test they're installed
python -c "import mcp; print('MCP OK')"
python -c "import httpx; print('httpx OK')"
python -c "import bs4; print('bs4 OK')"
```
---
## DO NOT Run Server Manually
**Don't do this**:
```powershell
python server.py # ❌ This will just wait forever
```
**Instead, let Claude Desktop handle it automatically!**
The server will:
- ✅ Start automatically when Claude needs it
- ✅ Stop automatically when done
- ✅ Show up as available tools in Claude
---
## Quick Test Script
To verify everything works WITHOUT using Claude:
```powershell
cd C:\Users\Daniel\Documents\tamilrockersMcp
python test_db.py
```
This tests the database and search functions directly.
---
## What Success Looks Like
### In Claude Desktop:
1. Type: "Update moviesda database"
2. Claude responds: "✅ Database updated! Added 20 new movies"
3. Type: "Search for Raja Saab"
4. Claude responds: Shows movie link
### In PowerShell (test_db.py):
```
✅ Database initialized
✅ Added: The Raja Saab (2026)
✅ All tests completed successfully!
```
---
**Your server is ready!** Just configure Claude and start searching for movies! 🎬
