Back to MCP directory
publicPublicdnsLocal runtime

passport-mcp

PassportMCP是一个工具包,允许用户为任何网站构建MCP服务器,并自动同步浏览器认证信息。它通过Chrome扩展捕获认证状态,本地存储并注入到HTTP请求中,无需开发者API即可访问网站数据。

article

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 网上应用商店

  1. 访问 PassportMCP Chrome 扩展
  2. 点击 "添加到Chrome"
  3. 按照提示完成安装和设置

本地开发

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 了解详细信息

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client