PassportMCP

PassportMCP

site icon
2025.02.01 31
PythonMCP服务器构建浏览器认证同步浏览器自动化开发效率
PassportMCP (ppmcp) 是一个用于构建MCP服务器的工具,能够自动同步浏览器认证信息,适用于任何网站。它封装了FastMCP,并自动将浏览器中的必要认证头和cookie添加到出站请求中。只要通过浏览器登录,即可使用。它比付费的开发者API(如Twitter/X)更简单,可以避免速率限制、等待批准,或者适用于没有API的网站。如果不构建MCP服务器,还可以使用超轻量级的`BrowserPassport` HTTP客户端。
View on GitHub

Overview

基本能力

产品定位

PassportMCP 是一个用于构建MCP服务器的工具,能够自动同步浏览器认证信息,适用于任何网站。

核心功能

  • 🔐 自动浏览器认证同步
  • 🛠️ 创建普通MCP工具
  • 🌐 适用于任何网站
  • 🔄 始终使用最新的认证状态
  • 🍪 处理cookie和headers
  • 🔒 所有凭证保留在本地机器上

适用场景

  • 构建MCP服务器
  • 避免付费API的速率限制
  • 适用于没有API的网站
  • 使用浏览器认证信息进行HTTP请求

工具列表

  • PassportMCP: 高级MCP工具创建
  • BrowserPassport: 低级认证处理

常见问题解答

  • 安全性:凭证从不离开本地机器,没有云存储或传输,仅限于授权域,LLM永远不会看到凭证。

使用教程

使用依赖

  • 安装Python包管理工具pip

安装教程

  1. 安装包
pip install ppmcp
  1. 设置本地消息和认证同步
ppmcp setup  # 使用Chrome Web Store扩展设置
  1. 启用请求监控
  2. 点击Chrome中的PassportMCP扩展图标
  3. 打开“Monitor Requests”
  4. 访问并登录目标网站

调试方式

  • 使用ppmcp doctor检查安装状态
  • 使用ppmcp uninstall卸载PassportMCP

高级示例

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()

BrowserPassport HTTP客户端

from passportmcp import BrowserPassport

client = BrowserPassport()
response = client.get("https://api.example.com/data")
data = response.json()

许可证

该项目遵循 MIT 开源许可条款。