README
🚀 护照MCP(PassportMCP)
护照MCP (ppmcp) 能够助力您为任意网站搭建 MCP 服务器,实现浏览器身份验证的自动同步,适用范围覆盖所有网站。它对 FastMCP 进行了封装,会自动将必要的身份验证头和浏览器中的 Cookie 添加到传出请求中。只需通过浏览器完成登录,即可随时使用。相较于购买开发者 API(如 Twitter/X)、避免速率限制、等待审批,或者在没有 API 的网站上使用,它的操作更为简便。
若无需构建 MCP 服务器,您可直接使用轻量级的 BrowserPassport HTTP 客户端!向下滚动
🚀 快速开始
pip install ppmcp # 安装 PassportMCP
ppmcp init # 初始化新项目
cd my-project && npm run dev # 开发模式启动
✨ 主要特性
- 🔐 浏览器身份验证自动同步
- 🛠️ 常规 MCP 工具创建
- 🌐 支持任意网站
- 🔄 总是使用最新的身份验证状态
- 📦 凭证从不离开您的设备
- ✅ 安全受信任的域限制
📦 安装指南
通过 Chrome 网上应用商店
- 访问 PassportMCP Chrome 扩展
- 点击 "添加到Chrome"
- 按照提示完成安装和设置
本地开发
git clone git@github:passport-mcp.git
cd passport-mcp/python-sdk && pip install -e .
💻 使用示例
基础用法
护照MCP 的工作流程如下:
# 在浏览器中安装扩展
# 使用 `ppmcp init` 初始化新项目
ppmcp init
# 添加目标网站到受信任域列表
# 开发模式启动服务器
npm run dev
高级用法
从剪贴板粘贴凭证
ppmcp login --clipboard
打包和部署
npm run build && npm start
🔧 技术细节
安全
- ✅ 凭证从未离开您的设备
- ✅ 不进行云端存储或传输
- ✅ 仅限授权域使用
- ✅ LLM 永远不会看到您的凭证
与 Anon 和 Rabbit 等基于云的账户自动化服务不同,PassportMCP 将所有内容保持在本地环境,确保安全性。
开发
对于 SDK 开发:
cd sdks/python && pip install -e .
项目结构
passport-mcp/
├── extension/ # Chrome 扩展
├── sdks/
│ ├── python/ # Python SDK
│ └── typescript/ # TypeScript SDK(即将推出)
└── shared/
└── native-host/ # 原生消息宿主
路线图
- [ ] TypeScript SDK
- [ ] Firefox 扩展
- [ ] Safari 扩展
- [ ] 身份验证状态共享
- [ ] 企业功能
- [ ] 更多语言 SDK
📄 许可证
MIT License - 请参阅 LICENSE 了解详细信息
Scan to join WeChat group