Primp MCP Server
A Model Context Protocol (MCP) server that provides access to the primp HTTP client library with browser impersonation capabilities.
Features
- Browser Impersonation: Impersonate various browsers (Chrome, Firefox, Safari, Edge) and operating systems
- HTTP Methods: Support for GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
- Authentication: Basic auth and Bearer token support
- Proxy Support: HTTP/HTTPS proxy support
- File Uploads: Multipart form data file uploads
- Response Formats: Return responses as text, JSON, markdown, plain text, or rich text
- Advanced Options: Configurable timeouts, redirect handling, SSL verification
Installation
pip install -e .
Usage
The server provides two main tools:
1. primp_request
Make HTTP requests with browser impersonation (note, these instructions are for the LLM):
# Example usage in MCP client
{
"name": "primp_request",
"arguments": {
"url": "https://httpbin.org/get",
"method": "GET",
"impersonate": "chrome_131",
"impersonate_os": "windows",
"headers": {
"User-Agent": "My-App/1.0"
},
"return_format": "json"
}
}
2. primp_upload
Upload files using multipart form data:
# Example usage in MCP client
{
"name": "primp_upload",
"arguments": {
"url": "https://httpbin.org/post",
"files": [
{
"name": "file",
"filename": "example.txt",
"content": "SGVsbG8gV29ybGQ=", # base64 encoded
"content_type": "text/plain"
}
],
"data": {
"description": "Test upload"
}
}
}
Configuration
Add to your MCP settings:
{
"mcpServers": {
"primp": {
"command": "primp-mcp"
}
}
}
Supported Browsers
- Chrome (versions 99-131)
- Firefox (versions 99-133)
- Safari (versions 12-18, including iPad/iPhone)
- Edge (versions 99-131)
- OkHttp (versions 3.14.9-5.0.0)
Supported Operating Systems
- Windows
- macOS
- Linux
- Android
- iOS
License
MIT