浏览器Cookie管理服务

MCP Cookie

一种模型上下文协议（MCP）服务器，为LLM提供cookie感知的web获取功能。此服务器允许LLM从已安装的浏览器中使用Cookie获取web内容和下载文件，并在Cookie过期时自动处理身份验证流。

特性

• 多浏览器支持：从Chrome、Edge、Brave、Opera、Firefox和Safari中提取Cookie
• 交叉平台的：适用于Windows、macOS和Linux（支持特定于平台的浏览器）
• 自动登录处理：检测过期的Cookie并打开浏览器进行重新身份验证
• 智能Cookie提取：仅从请求的特定浏览器中提取Cookie
• 默认浏览器检测：自动检测并使用系统的默认浏览器
• 大文件支持：大文件的流式下载和进度报告
• 二进制文件支持：正确处理文本和二进制文件下载

安装

npm install

用法

作为MCP服务器

添加到MCP客户端配置中：

{
  "mcpServers": {
    "cookies": {
      "command": "node",
      "args": ["/path/to/mcp-cookies/index.js"]
    }
  }
}

可用工具

fetch_with_cookies

使用浏览器Cookie获取URL。

{
  url: string,              // URL to fetch
  browser?: string,         // Browser to use (default: system default)
  auto_login?: boolean      // Auto-open browser if login needed (default: true)
}

download_with_cookies

使用浏览器Cookie将文件下载到磁盘。

{
  url: string,              // URL to download
  output_path?: string,     // Where to save (optional)
  browser?: string,         // Browser to use (default: system default)
  auto_login?: boolean      // Auto-open browser if login needed (default: true)
}

浏览器支持

运作原理

1. Cookie提取：服务器直接从浏览器cookie存储中读取cookie：

   • Chromium浏览器：用途 chrome-cookies-secure 解密Cookie
   • Firefox：从SQLite数据库读取(cookies.sqlite)
   • Safari：用途 @mherod/get-cookie 在 macOS 上

2. 登录检测：在获取/下载时，服务器通过以下方式检测登录页面：

   • 使用登录指示器检查重定向到不同域的情况
   • 扫描登录表单的HTML内容
   • 识别常见的SSO提供者（Okta、Auth0等）

3. 自动重新身份验证：如果需要登录：

   • 打开用户的浏览器进入登录页面
   • 等待身份验证完成（每5秒检查一次）
   • 使用新Cookie自动重试
   • 返回最初请求的内容

发展

# Run the server
npm start

# Run in development mode
node index.js

安全考虑

• Cookie仅从本地浏览器存储中读取
• MCP服务器不传输或存储Cookie
• Cookie仅用于请求的特定域
• 所有cookie访问都是只读的

需求

• Node.js 18+
• 已安装支持的浏览器
• Windows：某些浏览器可能需要升级
• macOS：可能需要Chrome/Edge的钥匙链访问权限

许可证

麻省理工学院