Senzing MCP Server

# ChatGPT Desktop Setup for Remote Senzing MCP Server (Mac) ## Overview This guide configures ChatGPT Desktop on your Mac to connect to the Senzing MCP server running on remote server **192.168.2.111** via SSH. ## Prerequisites - ChatGPT Desktop App installed on your Mac - SSH access to 192.168.2.111 as user `jbutcher` - SSH key at `~/.ssh/id_rsa` on your Mac ## Setup Steps ### 1. Test SSH Connection First Before proceeding, verify you can SSH to the remote server: ```bash ssh -i ~/.ssh/id_rsa jbutcher@192.168.2.111 "echo 'SSH connection works'" ``` If this fails, you may need to: - Add your SSH key: `ssh-add ~/.ssh/id_rsa` - Or configure SSH config file (see "SSH Configuration" section below) ### 2. Copy Launch Script to Your Mac On your **Mac**, create a directory and copy the launch script: ```bash # Create directory mkdir -p ~/senzing-mcp # Copy the SSH launch script from the remote server scp jbutcher@192.168.2.111:/data/etl/senzing/er/v4beta/senzingMCP/launch_senzing_mcp_ssh.sh \ ~/senzing-mcp/ # Make it executable chmod +x ~/senzing-mcp/launch_senzing_mcp_ssh.sh ``` ### 3. Configure ChatGPT Desktop Create the ChatGPT MCP configuration directory and file: ```bash # Create the configuration directory mkdir -p ~/Library/Application\ Support/ChatGPT/ # Create the MCP configuration file cat > ~/Library/Application\ Support/ChatGPT/mcp_config.json << 'EOF' { "mcpServers": { "senzing": { "command": "/Users/jbutcher/senzing-mcp/launch_senzing_mcp_ssh.sh", "description": "Senzing Entity Resolution MCP Server (via SSH to 192.168.2.111)", "env": {} } } } EOF ``` ### 4. Restart ChatGPT Desktop 1. Quit ChatGPT Desktop completely 2. Relaunch ChatGPT Desktop 3. The Senzing MCP server should now be available ## Verification ### Test the Launch Script Manually Before using with ChatGPT, test the launch script: ```bash ~/senzing-mcp/launch_senzing_mcp_ssh.sh ``` You should see log messages indicating the Senzing MCP server started. Press Ctrl+C to stop. ### Test in ChatGPT Open ChatGPT and try these queries: 1. "What MCP servers are available?" - Should show "senzing" 2. "Search for entities named Robert Smith" - Should return entity results 3. "Get details for entity 1" - Should return comprehensive entity data ## SSH Configuration (Optional but Recommended) To avoid specifying the SSH key path every time, add this to `~/.ssh/config`: ``` Host senzing-server HostName 192.168.2.111 User jbutcher IdentityFile ~/.ssh/id_rsa ServerAliveInterval 60 ServerAliveCountMax 3 ``` Then update the launch script to use: `ssh senzing-server` instead of the full command. ## Troubleshooting ### "Permission denied" SSH Error ```bash # Add your SSH key to the agent ssh-add ~/.ssh/id_rsa # Verify the key is added ssh-add -l ``` ### "Connection refused" or Timeout - Verify the server is reachable: `ping 192.168.2.111` - Check firewall settings on 192.168.2.111 - Ensure SSH is running on the remote server ### MCP Server Not Appearing in ChatGPT 1. Check the configuration file exists: ```bash cat ~/Library/Application\ Support/ChatGPT/mcp_config.json ``` 2. Verify the launch script path is correct: ```bash ls -l ~/senzing-mcp/launch_senzing_mcp_ssh.sh ``` 3. Test the launch script manually (see Verification section) ### ChatGPT Shows Connection Errors 1. Check ChatGPT logs (if available) 2. Test SSH connection manually 3. Verify the remote Senzing environment is set up correctly: ```bash ssh jbutcher@192.168.2.111 "source /data/etl/senzing/er/v4beta/setupEnv && echo \$SENZING_ENGINE_CONFIGURATION_JSON" ``` ### Slow Response Times The SSH connection may add latency. This is normal for remote MCP servers. Each query requires: 1. SSH connection establishment 2. Remote script execution 3. Senzing query processing 4. Response transmission back ## Available Tools Once configured, ChatGPT can use these Senzing tools: 1. **search_entities** - Search by name, address, phone, email, DOB 2. **get_entity** - Get full entity details by ID 3. **find_relationship_path** - Find connection between entities 4. **find_network** - Discover related entity networks 5. **explain_relationship** - Explain why entities are related 6. **explain_entity_resolution** - Show how entity was resolved 7. **get_stats** - Get Senzing engine statistics 8. **get_config_info** - Get configuration info ## Example Queries for ChatGPT - "Search for all entities with the name John Smith" - "Get the complete details for entity ID 1" - "Show me how entity 1 was resolved from its source records" - "Find the relationship path between entity 1 and entity 8" - "Explain why entity 1 and entity 8 are related" - "Find the network of entities related to entity 20" - "What are the Senzing statistics?" ## Security Notes - The SSH connection uses key-based authentication (more secure than passwords) - The MCP server is **read-only** - no data modification is possible - Each ChatGPT session creates a fresh SSH connection - The server connection is closed when ChatGPT finishes the query ## Files Reference **On your Mac:** - Launch script: `~/senzing-mcp/launch_senzing_mcp_ssh.sh` - ChatGPT config: `~/Library/Application Support/ChatGPT/mcp_config.json` **On remote server (192.168.2.111):** - Remote launch script: `/data/etl/senzing/er/v4beta/senzingMCP/launch_senzing_mcp.sh` - MCP server: `/data/etl/senzing/er/v4beta/senzingMCP/venv/bin/senzing-mcp` - Environment setup: `/data/etl/senzing/er/v4beta/setupEnv`