.png)
5 hours ago
1
Installation
🍎 macOS Users - Choose the Right Version!
Check your Mac type first:
- Apple Silicon (M1/M2/M3): Download whoismcp-server-macos-arm64
- Intel Macs: Download whoismcp-server-macos-x86_64
⚠️ Getting "bad CPU type" error? You downloaded the wrong architecture!
🪟 Windows Users
Download whoismcp-server-windows-x86_64.exe
🐧 Linux Users
Download whoismcp-server-linux-x86_64
Setup Instructions
- Download the appropriate binary for your platform
- Make it executable (on macOS/Linux): chmod +x whoismcp-server-*
- Place it in a convenient location (e.g., /usr/local/bin or ~/bin)
MCP Configuration
Add the WhoisMCP server to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Edit the configuration file and add the following to the mcpServers object:
{
"mcpServers": {
// ... your existing MCP servers ...
"whoismcp": {
"command": "/path/to/whoismcp-server",
"args": [],
"env": {}
}
}
}
Important:
- Replace /path/to/whoismcp-server with the actual path to your downloaded binary
- If you have other MCP servers already configured, add the "whoismcp" entry after them (don't forget the comma before it)
- On Windows, use forward slashes or escaped backslashes: "C:/path/to/whoismcp-server.exe" or "C:\\path\\to\\whoismcp-server.exe"
Environment Variables (Optional)
You can customize the server behavior by adding environment variables to the env object:
"whoismcp": {
"command": "/path/to/whoismcp-server",
"args": [],
"env": {
"WHOIS_TIMEOUT": "60",
"RDAP_TIMEOUT": "60",
"CACHE_TTL": "7200",
"LOG_LEVEL": "INFO"
}
}
Available environment variables:
- WHOIS_TIMEOUT: Whois query timeout in seconds (default: 30)
- RDAP_TIMEOUT: RDAP query timeout in seconds (default: 30)
- CACHE_TTL: Cache time-to-live in seconds (default: 3600)
- CACHE_MAX_SIZE: Maximum cache entries (default: 1000)
- LOG_LEVEL: Logging level - DEBUG, INFO, WARNING, ERROR (default: INFO)
Verification
After updating the configuration:
- Restart Claude Desktop
- Look for "whoismcp" in the MCP servers list
- Test with queries like:
- "Look up the domain example.com"
- "Get RDAP info for google.com"
- "Check whois for IP 8.8.8.8"
Supported Platforms
- Linux: x86_64
- macOS: x86_64 (Intel) and arm64 (Apple Silicon)
- Windows: x86_64
Troubleshooting
If the server doesn't appear in Claude:
- Check that the binary path is correct in the config
- Ensure the binary has execute permissions (macOS/Linux)
- Check Claude's logs for any error messages
- Try running the binary directly to test: ./whoismcp-server --help
See the README for full documentation.
