CURSOR_SETUP.md•2.56 kB
# Cursor MCP Setup Guide
## The Issue
You're seeing "no tools, prompts or resources" in Cursor because the MCP server needs to be properly configured and running.
## Solution Steps
### 1. Use the Project-Specific Configuration
I've created a `.cursor/mcp.json` file in your project directory. This is the recommended way to configure MCP servers for Cursor.
### 2. Restart Cursor
After adding the MCP configuration, you need to restart Cursor completely for it to pick up the new configuration.
### 3. Check MCP Settings
1. Open Cursor Settings (Cmd+, on Mac)
2. Go to Features > MCP
3. You should see "license-scanner" listed
4. Click the refresh button next to it
### 4. Test the Server Manually
Before using it in Cursor, test that the server works:
```bash
cd /Users/ryancadby/sites/_apps/cursor_hackathon
source venv/bin/activate
python minimal_mcp.py
```
You should see the FastMCP banner and "Starting MCP server" message.
### 5. Alternative: Global Cursor Configuration
If the project-specific config doesn't work, try adding it to your global Cursor settings:
1. Open Cursor Settings
2. Go to Features > MCP
3. Click "+ Add New MCP Server"
4. Configure:
- **Name**: `license-scanner`
- **Type**: `stdio`
- **Command**: `/Users/ryancadby/sites/_apps/cursor_hackathon/start_minimal.sh`
### 6. Verify Tools are Available
Once configured, you should see:
- `scan_dependencies`
- `generate_license_report`
- `list_package_managers`
## Troubleshooting
### If tools still don't appear:
1. **Check the server is running**: Look for the FastMCP banner when starting
2. **Check permissions**: Make sure the shell script is executable (`chmod +x`)
3. **Check Python environment**: Ensure the virtual environment is activated
4. **Check Cursor logs**: Look for MCP-related errors in Cursor's developer console
### Common Issues:
- **Virtual environment not activated**: The server needs the FastMCP dependencies
- **Wrong path**: Make sure all paths in the configuration are absolute
- **Permission denied**: Make sure the shell script is executable
- **Cursor not restarted**: MCP configuration changes require a full restart
## Testing the Tools
Once the tools appear in Cursor, you can test them by:
1. Opening Composer (Cmd+I)
2. Asking: "Use the scan_dependencies tool to scan this project"
3. Or: "List the package managers in this directory"
## Next Steps
Once the minimal server works, you can switch back to the full license scanner by updating the `.cursor/mcp.json` file to use `start_server.sh` instead of `start_minimal.sh`.