# Complete Usage Guide - Moviesda MCP Server
## Step 1: Configure Claude Desktop
### Find the Claude Configuration File
The configuration file is located at:
```
C:\Users\Daniel\AppData\Roaming\Claude\claude_desktop_config.json
```
### Option A: Edit Manually
1. **Open File Explorer**
2. **Paste this path in the address bar**:
```
C:\Users\Daniel\AppData\Roaming\Claude
```
3. **If the folder doesn't exist**, create it:
- Create folder `Claude` in `C:\Users\Daniel\AppData\Roaming\`
4. **Open or create the file** `claude_desktop_config.json`
5. **Paste this configuration**:
```json
{
"mcpServers": {
"moviesda": {
"command": "python",
"args": ["C:\\Users\\Daniel\\Documents\\tamilrockersMcp\\server.py"]
}
}
}
```
6. **Save the file**
### Option B: Use PowerShell Commands
Run these commands in PowerShell:
```powershell
# Create the Claude config directory if it doesn't exist
$claudeConfigDir = "$env:APPDATA\Claude"
if (-not (Test-Path $claudeConfigDir)) {
New-Item -ItemType Directory -Path $claudeConfigDir -Force
}
# Create the config file
$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 "✅ Configuration created at: $configPath"
```
---
## Step 2: Restart Claude Desktop
**IMPORTANT**: After editing the config file:
1. **Completely close Claude Desktop** (exit from system tray too)
2. **Reopen Claude Desktop**
---
## Step 3: Verify MCP Server is Connected
In a new Claude conversation:
1. Look for a **🔌 hammer/tool icon** in the message input area
2. Click it to see available tools
3. You should see three tools:
- `search_movie`
- `add_movie`
- `update_movies`
---
## Step 4: Using the MCP Server
### First Time Setup: Update Database
**Type this in Claude**:
```
Use the update_movies tool to populate the database with movies from moviesda16.com
```
Claude will:
1. Call the `update_movies` tool
2. Scrape movies from the website
3. Add them to your local database
4. Show you how many movies were added
**Expected Output**:
```
✅ Database updated! Added 20 new movies from moviesda16.com
```
---
### Search for a Movie
**Type in Claude**:
```
Search for "Raja Saab" movies in the moviesda database
```
OR be more specific:
```
Use the search_movie tool to find movies with "Parasakthi" in the title
```
**Expected Output**:
```
Found 1 movie(s) matching 'Parasakthi':
1. Parasakthi (2026)
🔗 Link: https://moviesda16.com/parasakthi-2026-tamil-movie/
```
---
### Add a Movie Manually
**Type in Claude**:
```
Add a new movie to the database with title "Test Movie", year 2026, and URL "/test-movie-2026/"
```
**Expected Output**:
```
✅ Successfully added 'Test Movie' to the database
```
---
## Step 5: Sample Queries
### Example 1: Simple Search
```
Find Tamil movies with "Kohrra" in the title
```
### Example 2: Multiple Results
```
Search for movies containing "Tamil" and show me the top 5 results
```
### Example 3: Update and Search
```
First update the movie database, then search for "IPL"
```
### Example 4: Check a specific movie
```
Is "The Raja Saab" available in the moviesda database?
```
---
## Troubleshooting
### Issue: Tools not showing in Claude
**Solution**:
1. Check config file exists at: `C:\Users\Daniel\AppData\Roaming\Claude\claude_desktop_config.json`
2. Verify Python is installed: `python --version`
3. Verify file path is correct in config
4. **Restart Claude Desktop completely**
### Issue: "python not found" error
**Solution**:
```powershell
# Verify Python is in PATH
python --version
# If not found, reinstall Python with "Add to PATH" checked
```
### Issue: Server crashes when calling tools
**Solution**:
```powershell
# Install dependencies
cd C:\Users\Daniel\Documents\tamilrockersMcp
pip install -r requirements.txt
# Test server manually
python test_db.py
```
### Issue: "Module not found" error
**Solution**:
```powershell
# Reinstall all dependencies
pip install --upgrade mcp httpx beautifulsoup4
```
---
## How MCP Works Behind the Scenes
When you ask Claude to search for a movie:
1. **Claude understands your request** and decides to use the `search_movie` tool
2. **Claude Desktop launches** `python server.py` in the background
3. **The server receives** the search query
4. **SQLite database is queried** for matching movies
5. **Results are returned** to Claude
6. **Claude formats and shows** you the results
The server **automatically starts and stops** as needed - you don't need to manually run `python server.py`!
---
## View Server Logs (Advanced)
If you want to see what's happening, you can run the server manually:
```powershell
cd C:\Users\Daniel\Documents\tamilrockersMcp
python server.py
```
Then in Claude, try using the tools. You'll see the requests in the terminal.
**Press `Ctrl+C` to stop the manual server.**
---
## Configuration Reference
### Full Config with Multiple Servers
```json
{
"mcpServers": {
"moviesda": {
"command": "python",
"args": ["C:\\Users\\Daniel\\Documents\\tamilrockersMcp\\server.py"]
},
"other-server": {
"command": "node",
"args": ["path/to/other/server.js"]
}
}
}
```
### Environment Variables (if needed)
```json
{
"mcpServers": {
"moviesda": {
"command": "python",
"args": ["C:\\Users\\Daniel\\Documents\\tamilrockersMcp\\server.py"],
"env": {
"DEBUG": "true"
}
}
}
}
```
---
## Quick Reference Card
| What You Want | What To Say in Claude |
|---------------|----------------------|
| Get latest movies | "Update the moviesda database" |
| Find a movie | "Search for [movie name] in moviesda" |
| Add a movie | "Add [movie name] (year) to moviesda with URL [/path/]" |
| List all tools | Click the 🔌 icon in message box |
---
**Need Help?** If something isn't working, share the error message and I'll help troubleshoot! 🚀
