# Setting Up Filmladder MCP Server in Cursor
This guide explains how to connect the Filmladder MCP server to Cursor IDE.
## Quick Setup
The project includes a `.cursor/mcp.json` configuration file. Cursor should automatically detect it when you open this project.
## Manual Setup
If automatic detection doesn't work, follow these steps:
### Step 1: Open Cursor Settings
1. Click the **gear icon** (⚙️) in the upper right corner of Cursor
2. Navigate to **Tools & Integrations** → **MCP Tools**
3. Click **Add Custom MCP** or edit the `mcp.json` file
### Step 2: Add Server Configuration
Add the following configuration to your `mcp.json`:
```json
{
"mcpServers": {
"filmladder-mcp": {
"command": "poetry",
"args": ["run", "python", "-m", "src.server"],
"cwd": "/Users/danielsteman/repos/filmladder-mcp"
}
}
}
```
**Important**:
- Replace `/Users/danielsteman/repos/filmladder-mcp` with the actual absolute path to this project directory
- Make sure Poetry is installed and available in your PATH
- Ensure you've run `poetry install` in this project directory
### Step 3: Verify Connection
1. Save the `mcp.json` file
2. Return to Cursor settings
3. Under **MCP Tools**, you should see "filmladder-mcp" listed
4. The status should show as connected (green indicator)
### Step 4: Test the Integration
Open Cursor's chat and try these prompts:
- "What movies are playing in Amsterdam today?"
- "When is Nuremberg playing?"
- "What movies are playing at Pathé Tuschinski?"
- "Recommend me a movie with rating above 7.0 for tonight"
## Configuration Locations
You can configure MCP servers in two places:
1. **Project-specific** (recommended): `.cursor/mcp.json` in this project directory
2. **Global**: `~/.cursor/mcp.json` in your home directory
## Troubleshooting
### Server not connecting
1. **Check Poetry path**: Make sure `poetry` is in your PATH:
```bash
which poetry
```
2. **Verify dependencies**: Ensure all dependencies are installed:
```bash
poetry install
```
3. **Test server manually**: Try running the server directly:
```bash
poetry run python -m src.server
```
If this fails, fix the issue before configuring in Cursor.
4. **Check Cursor logs**:
- Open Cursor's developer console (Help → Toggle Developer Tools)
- Look for MCP-related errors
### Server connects but tools don't work
1. **Check network access**: The server needs internet access to scrape filmladder.nl
2. **Verify tool registration**: Run `poetry run python test_server.py` to verify tools are registered
3. **Check Cursor MCP panel**: Look for any error messages in the MCP Tools section
## Alternative: Using Full Python Path
If Poetry isn't in your PATH, you can use the full path to Poetry:
```json
{
"mcpServers": {
"filmladder-mcp": {
"command": "/run/current-system/sw/bin/poetry",
"args": ["run", "python", "-m", "src.server"],
"cwd": "/Users/danielsteman/repos/filmladder-mcp"
}
}
}
```
Or use the Python interpreter directly from the Poetry virtual environment:
```json
{
"mcpServers": {
"filmladder-mcp": {
"command": "/Users/danielsteman/repos/filmladder-mcp/.venv/bin/python",
"args": ["-m", "src.server"],
"cwd": "/Users/danielsteman/repos/filmladder-mcp"
}
}
}
```
Replace the paths with your actual paths.
