| Name | ppmcp JSON |
| Version |
0.1.5
JSON |
| download |
| home_page | None |
| Summary | Python SDK for Passport MCP |
| upload_time | 2025-01-21 19:12:38 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | MIT |
| keywords |
automation
browser
mcp
passport
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# PassportMCP Python SDK
PassportMCP (ppmcp) lets you build MCP servers for any given website with automatic browser auth syncing. Every website is fair game. It wraps FastMCP and automatically adds necessary auth headers and cookies from the browser to outbound requests. As long as you log in through the browser, it's ready to be used. Often easier than paying for developer APIs (ex: twitter/X), avoiding rate limits, waiting for approval, or great for sites that don't have one.
## Features
- Automatic browser auth syncing (for any auth type)
- Normal MCP tool creation
- Works with any website
- Always uses latest auth state
- All credentials stay on your machine
## Quick Start
1. **Install the Package**
```bash
pip install ppmcp
```
2. **Set Up Native Messaging and Auth Syncing**
```bash
ppmcp setup # Sets up with Chrome Web Store extension
```
3. **Enable Request Monitoring**
- Click the PassportMCP extension icon in Chrome
- Toggle "Monitor Requests" on
- Visit and log into your target website
4. **Create Your First MCP Tool**
```python
from passportmcp import PassportMCP
# Create an MCP instance
mcp = PassportMCP("example", "example.com")
# Define a tool
@mcp.tool()
async def get_data():
response = mcp.client.get("https://example.com/api/data")
return response.json()
```
## Installation Options
### Option 1: Chrome Web Store Extension (Recommended)
```bash
pip install ppmcp
ppmcp setup
```
### Option 2: Local Development
1. **Build the Extension**
```bash
git clone https://github.com/joshmayerr/passport-mcp.git
cd extension
npm install
npm run build # or npm run dev for watch mode
```
2. **Load in Chrome**
- Open Chrome and go to `chrome://extensions`
- Enable "Developer mode" in the top right
- Click "Load unpacked" and select the `extension/dist` directory
- Note the extension ID from Chrome (shown under the extension name)
3. **Set Up Native Messaging**
```bash
ppmcp setup --local --extension-id=your_extension_id
# OR
ppmcp setup --local # You'll be prompted for the ID
```
### CLI Commands
- `ppmcp setup` - Set up native messaging
- `ppmcp doctor` - Check installation status
- `ppmcp uninstall` - Remove PassportMCP
## How It Works
PassportMCP consists of three main components:
1. **Chrome Extension**
- Monitors web requests
- Captures authentication state
- Sends to native host
2. **Native Host**
- Receives data from extension
- Stores authentication state
- Provides data to SDK
3. **SDK**
- PassportMCP: High-level MCP tool creation
- BrowserPassport: Low-level auth handling
## Advanced Example: LinkedIn API
```python
from passportmcp import PassportMCP
mcp = PassportMCP("linkedin", "linkedin.com")
@mcp.tool()
async def search_linkedin(query: str):
response = mcp.client.get(
"https://www.linkedin.com/voyager/api/graphql",
params={
"includeWebMetadata": "true",
"variables": "()",
"queryId": "voyagerDashMySettings.7ea6de345b41dfb57b660a9a4bebe1b8"
}
)
return response.json()
```
## Security
- ✅ Credentials never leave your machine
- ✅ No cloud storage or transmission
- ✅ Limited to authorized domains
- ✅ LLMs never see your credentials
Unlike services like Anon and Rabbit that automate accounts in the cloud, PassportMCP keeps everything local.
## Development
For SDK development:
```bash
cd sdks/python
pip install -e .
```
## Roadmap
- [ ] TypeScript SDK
- [ ] Firefox extension
- [ ] Safari extension
- [ ] Auth state sharing
- [ ] Enterprise features
- [ ] More language SDKs
## License
MIT License - see [LICENSE](LICENSE) for details
Raw data
{
"_id": null,
"home_page": null,
"name": "ppmcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "automation, browser, mcp, passport",
"author": null,
"author_email": "Josh Mayer <josh@tollbit.com>",
"download_url": "https://files.pythonhosted.org/packages/2f/28/e30cbc7b6e1abdb493e09ca1b41b8d3e4a0d9a723d9099a01fc2f82fb0e3/ppmcp-0.1.5.tar.gz",
"platform": null,
"description": "# PassportMCP Python SDK\n\nPassportMCP (ppmcp) lets you build MCP servers for any given website with automatic browser auth syncing. Every website is fair game. It wraps FastMCP and automatically adds necessary auth headers and cookies from the browser to outbound requests. As long as you log in through the browser, it's ready to be used. Often easier than paying for developer APIs (ex: twitter/X), avoiding rate limits, waiting for approval, or great for sites that don't have one.\n\n## Features\n\n- Automatic browser auth syncing (for any auth type)\n- Normal MCP tool creation\n- Works with any website\n- Always uses latest auth state\n- All credentials stay on your machine\n\n## Quick Start\n\n1. **Install the Package**\n\n```bash\npip install ppmcp\n```\n\n2. **Set Up Native Messaging and Auth Syncing**\n\n```bash\nppmcp setup # Sets up with Chrome Web Store extension\n```\n\n3. **Enable Request Monitoring**\n\n - Click the PassportMCP extension icon in Chrome\n - Toggle \"Monitor Requests\" on\n - Visit and log into your target website\n\n4. **Create Your First MCP Tool**\n\n```python\nfrom passportmcp import PassportMCP\n\n# Create an MCP instance\nmcp = PassportMCP(\"example\", \"example.com\")\n\n# Define a tool\n@mcp.tool()\nasync def get_data():\n response = mcp.client.get(\"https://example.com/api/data\")\n return response.json()\n```\n\n## Installation Options\n\n### Option 1: Chrome Web Store Extension (Recommended)\n\n```bash\npip install ppmcp\nppmcp setup\n```\n\n### Option 2: Local Development\n\n1. **Build the Extension**\n\n```bash\ngit clone https://github.com/joshmayerr/passport-mcp.git\ncd extension\nnpm install\nnpm run build # or npm run dev for watch mode\n```\n\n2. **Load in Chrome**\n\n - Open Chrome and go to `chrome://extensions`\n - Enable \"Developer mode\" in the top right\n - Click \"Load unpacked\" and select the `extension/dist` directory\n - Note the extension ID from Chrome (shown under the extension name)\n\n3. **Set Up Native Messaging**\n\n```bash\nppmcp setup --local --extension-id=your_extension_id\n# OR\nppmcp setup --local # You'll be prompted for the ID\n```\n\n### CLI Commands\n\n- `ppmcp setup` - Set up native messaging\n- `ppmcp doctor` - Check installation status\n- `ppmcp uninstall` - Remove PassportMCP\n\n## How It Works\n\nPassportMCP consists of three main components:\n\n1. **Chrome Extension**\n\n - Monitors web requests\n - Captures authentication state\n - Sends to native host\n\n2. **Native Host**\n\n - Receives data from extension\n - Stores authentication state\n - Provides data to SDK\n\n3. **SDK**\n - PassportMCP: High-level MCP tool creation\n - BrowserPassport: Low-level auth handling\n\n## Advanced Example: LinkedIn API\n\n```python\nfrom passportmcp import PassportMCP\n\nmcp = PassportMCP(\"linkedin\", \"linkedin.com\")\n\n@mcp.tool()\nasync def search_linkedin(query: str):\n response = mcp.client.get(\n \"https://www.linkedin.com/voyager/api/graphql\",\n params={\n \"includeWebMetadata\": \"true\",\n \"variables\": \"()\",\n \"queryId\": \"voyagerDashMySettings.7ea6de345b41dfb57b660a9a4bebe1b8\"\n }\n )\n return response.json()\n```\n\n## Security\n\n- \u2705 Credentials never leave your machine\n- \u2705 No cloud storage or transmission\n- \u2705 Limited to authorized domains\n- \u2705 LLMs never see your credentials\n\nUnlike services like Anon and Rabbit that automate accounts in the cloud, PassportMCP keeps everything local.\n\n## Development\n\nFor SDK development:\n\n```bash\ncd sdks/python\npip install -e .\n```\n\n## Roadmap\n\n- [ ] TypeScript SDK\n- [ ] Firefox extension\n- [ ] Safari extension\n- [ ] Auth state sharing\n- [ ] Enterprise features\n- [ ] More language SDKs\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python SDK for Passport MCP",
"version": "0.1.5",
"project_urls": null,
"split_keywords": [
"automation",
" browser",
" mcp",
" passport"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "cc9e680238d6d45bb73ac1a7688671669e84770d980f39f21e5d78df7aeaa846",
"md5": "1fb77396654d45dffc13d945e1e8bf47",
"sha256": "60be35f1e663cb7f0c1844d26f1751886e7b511b407b5fba02c2fe65e728ef17"
},
"downloads": -1,
"filename": "ppmcp-0.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1fb77396654d45dffc13d945e1e8bf47",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 12212,
"upload_time": "2025-01-21T19:12:35",
"upload_time_iso_8601": "2025-01-21T19:12:35.754369Z",
"url": "https://files.pythonhosted.org/packages/cc/9e/680238d6d45bb73ac1a7688671669e84770d980f39f21e5d78df7aeaa846/ppmcp-0.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2f28e30cbc7b6e1abdb493e09ca1b41b8d3e4a0d9a723d9099a01fc2f82fb0e3",
"md5": "af96e6daca03fd7f00e895c25795d63d",
"sha256": "e68f837cddec56f90050b489e2bd55b03b57f36de5782e33207e01bfbbe466f8"
},
"downloads": -1,
"filename": "ppmcp-0.1.5.tar.gz",
"has_sig": false,
"md5_digest": "af96e6daca03fd7f00e895c25795d63d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 9923,
"upload_time": "2025-01-21T19:12:38",
"upload_time_iso_8601": "2025-01-21T19:12:38.010284Z",
"url": "https://files.pythonhosted.org/packages/2f/28/e30cbc7b6e1abdb493e09ca1b41b8d3e4a0d9a723d9099a01fc2f82fb0e3/ppmcp-0.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-21 19:12:38",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "ppmcp"
}
