传输模式：

• 默认 (stdio)：本地 MCP 服务器的标准通信方式
• 可流式 HTTP：用于基于 Web 的 MCP 服务器
• 如果未指定传输方式，服务器将默认使用 stdio
• 在没有明确指定传输方式的情况下，交互式终端会显示一个选择提示

CLI 选项：

• --login - 打开浏览器登录并保存持久化配置文件
• --no-headless - 显示浏览器窗口（有助于调试抓取问题）
• --log-level {DEBUG,INFO,WARNING,ERROR} - 设置日志级别（默认：WARNING）
• --transport {stdio,streamable-http} - 可选：强制指定传输模式（默认：stdio）
• --host HOST - HTTP 服务器主机（默认：127.0.0.1）
• --port PORT - HTTP 服务器端口（默认：8000）
• --path PATH - HTTP 服务器路径（默认：/mcp）
• --logout - 清除存储的 LinkedIn 浏览器配置文件
• --timeout MS - 页面操作的浏览器超时时间，单位为毫秒（默认：5000）
• --user-data-dir PATH - 持久化浏览器配置文件目录路径（默认：~/.linkedin-mcp/profile）
• --chrome-path PATH - Chrome/Chromium 可执行文件路径（用于自定义浏览器安装）

基本使用示例：

# 使用调试日志运行
uvx linkedin-scraper-mcp@latest --log-level DEBUG

HTTP 模式示例（适用于基于 Web 的 MCP 客户端）：

uvx linkedin-scraper-mcp@latest --transport streamable-http --host 127.0.0.1 --port 8080 --path /mcp

运行时的服务器日志由 FastMCP/Uvicorn 输出。

工具调用会在单个服务器进程中序列化，以保护共享的 LinkedIn 浏览器会话。并发客户端请求会被排队，而不是并行执行。使用 --log-level DEBUG 可查看抓取锁的等待/获取/释放日志。

使用 mcp 检查器测试：

1. 安装并运行 mcp 检查器 bunx @modelcontextprotocol/inspector
2. 点击预填好的令牌 URL，在浏览器中打开检查器
3. 将“传输类型”选择为“可流式 HTTP”
4. 将“URL”设置为“http://localhost:8080/mcp”
5. 连接
6. 测试工具

安装问题：

• 确保已安装 uv：curl -LsSf https://astral.sh/uv/install.sh | sh
• 检查 uv 版本：uv --version（应为 0.4.0 或更高）
• 首次运行时，uvx 会下载所有 Python 依赖项。在网速较慢的情况下，uv 默认的 30 秒 HTTP 超时可能过短。上述推荐配置已将 UV_HTTP_TIMEOUT=300（秒）设置，以避免此问题。

会话问题：

• 浏览器配置文件存储在 ~/.linkedin-mcp/profile/
• 管理的浏览器下载缓存存储在 ~/.linkedin-mcp/patchright-browsers/
• 确保一次只保持一个活跃的 LinkedIn 会话

登录问题：

• LinkedIn 可能需要在 LinkedIn 移动应用中进行登录确认才能完成 --login
• 如果您频繁登录，可能会遇到验证码挑战。运行 uvx linkedin-scraper-mcp@latest --login 会打开一个浏览器窗口，您可以在其中手动解决验证码。

超时问题：

• 如果页面无法加载或找不到元素，请尝试增加超时时间：--timeout 10000
• 网速较慢的用户可能需要更高的值（例如 15000–30000 毫秒）
• 也可以通过环境变量设置：TIMEOUT=10000

自定义 Chrome 路径：

• 如果 Chrome 安装在非标准位置，可以使用 --chrome-path /path/to/chrome
• 也可以通过环境变量设置：CHROME_PATH=/path/to/chrome

首次设置行为：

• Claude Desktop 会立即启动套件；浏览器设置将在后台继续进行
• 如果 Patchright Chromium 浏览器仍在下载中，请稍后再试工具
• 管理的浏览器下载共享存储在 ~/.linkedin-mcp/patchright-browsers/

登录问题：

• 确保一次只保持一个活跃的 LinkedIn 会话
• LinkedIn 可能需要在 LinkedIn 移动应用中进行登录确认才能完成 --login
• 如果您频繁登录，可能会遇到验证码挑战。运行 uvx linkedin-scraper-mcp@latest --login 会打开一个浏览器窗口，您可以在其中手动解决验证码。请参阅 uvx 设置 了解先决条件。

超时问题：

• 如果页面无法加载或找不到元素，请尝试增加超时时间：--timeout 10000
• 网速较慢的用户可能需要更高的值（例如 15000–30000 毫秒）
• 也可以通过环境变量设置：TIMEOUT=10000

传输模式：

• 默认 (stdio)：用于本地 MCP 服务器的标准通信
• 可流式 HTTP：适用于基于 Web 的 MCP 服务器
• 如果未指定传输方式，服务器将默认使用 stdio
• 在没有明确指定传输方式的情况下，交互式终端会显示一个选择提示

CLI 选项：

• --log-level {DEBUG,INFO,WARNING,ERROR} - 设置日志级别（默认：WARNING）
• --transport {stdio,streamable-http} - 可选：强制指定传输模式（默认：stdio）
• --host HOST - HTTP 服务器主机（默认：127.0.0.1）
• --port PORT - HTTP 服务器端口（默认：8000）
• --path PATH - HTTP 服务器路径（默认：/mcp）
• --logout - 清除所有存储的 LinkedIn 身份验证状态，包括源和派生的运行时配置文件
• --timeout MS - 浏览器页面操作的超时时间，单位为毫秒（默认：5000）
• --user-data-dir PATH - 持久化浏览器配置文件目录的路径（默认：~/.linkedin-mcp/profile）
• --chrome-path PATH - Chrome/Chromium 可执行文件的路径（在 Docker 中很少需要）

[!NOTE] --login 和 --no-headless 在 Docker 中不可用（因为没有显示服务器）。请使用 uvx 设置 来创建配置文件。

HTTP 模式示例（适用于基于 Web 的 MCP 客户端）：

docker run -it --rm \
  -v ~/.linkedin-mcp:/home/pwuser/.linkedin-mcp \
  -p 8080:8080 \
  stickerdaniel/linkedin-mcp-server:latest \
  --transport streamable-http --host 0.0.0.0 --port 8080 --path /mcp

运行时服务器日志由 FastMCP/Uvicorn 输出。

使用 mcp 检查器进行测试：

1. 安装并运行 mcp 检查器 bunx @modelcontextprotocol/inspector
2. 点击预填充的令牌 URL，在浏览器中打开检查器
3. 将“传输类型”设置为“可流式 HTTP”
4. 将“URL”设置为“http://localhost:8080/mcp”
5. 连接
6. 测试工具

Docker 问题：

• 确保已安装 Docker
• 检查 Docker 是否正在运行：docker ps

登录问题：

• 确保一次只保持一个活动的 LinkedIn 会话
• 使用 --login 时，LinkedIn 可能会在手机应用中要求登录确认
• 如果您频繁登录，可能会遇到验证码挑战。此时可以运行 uvx linkedin-scraper-mcp@latest --login，这将打开一个浏览器窗口，您可以在其中手动解决验证码。有关先决条件，请参阅 uvx 设置。
• 如果在主机上重新登录后，Docker 的身份验证信息过期，请重启一次 Docker，以便它能够从新的源会话中重新建立连接。

超时问题：

• 如果页面无法加载或找不到元素，可以尝试增加超时时间：--timeout 10000
• 对于网络较慢的用户，可能需要更高的值（例如 15000-30000 毫秒）
• 也可以通过环境变量设置：TIMEOUT=10000

自定义 Chrome 路径：

• 如果 Chrome 安装在非标准位置，可以使用 --chrome-path /path/to/chrome
• 也可以通过环境变量设置：CHROME_PATH=/path/to/chrome

命令行选项：

• --login - 打开浏览器进行登录并保存持久化配置文件
• --no-headless - 显示浏览器窗口（有助于调试抓取问题）
• --log-level {DEBUG,INFO,WARNING,ERROR} - 设置日志级别（默认：WARNING）
• --transport {stdio,streamable-http} - 可选：强制传输模式（默认：stdio）
• --host HOST - HTTP服务器主机（默认：127.0.0.1）
• --port PORT - HTTP服务器端口（默认：8000）
• --path PATH - HTTP服务器路径（默认：/mcp）
• --logout - 清除存储的LinkedIn浏览器配置文件
• --timeout MS - 浏览器页面操作超时时间，单位为毫秒（默认：5000）
• --status - 检查当前会话是否有效并退出
• --user-data-dir PATH - 持久化浏览器配置文件目录路径（默认：~/.linkedin-mcp/profile）
• --slow-mo MS - 浏览器操作之间的延迟时间，单位为毫秒（默认：0，可用于调试）
• --user-agent STRING - 自定义浏览器用户代理
• --viewport WxH - 浏览器视口大小（默认：1280x720）
• --chrome-path PATH - Chrome/Chromium可执行文件路径（用于自定义浏览器安装）
• --help - 显示帮助信息

注意： 大多数命令行选项都有对应的环境变量。详情请参阅 .env.example。

HTTP模式示例（适用于基于Web的MCP客户端）：

uv run -m linkedin_mcp_server --transport streamable-http --host 127.0.0.1 --port 8000 --path /mcp

Claude Desktop：

{
  "mcpServers": {
    "linkedin": {
      "command": "uv",
      "args": ["--directory", "/path/to/linkedin-mcp-server", "run", "-m", "linkedin_mcp_server"]
    }
  }
}

此配置默认使用 stdio 模式。

登录问题：

• 确保一次只保持一个活跃的LinkedIn会话
• 使用 --login 时，LinkedIn可能需要在手机App中进行登录确认
• 如果频繁登录，可能会触发验证码挑战。--login 命令会打开浏览器，您可以在其中手动解决验证码。

抓取问题：

• 使用 --no-headless 查看浏览器操作过程，以便调试抓取问题
• 添加 --log-level DEBUG 以获取更详细的日志信息

会话问题：

• 浏览器配置文件存储在 ~/.linkedin-mcp/profile/
• 使用 --logout 清除配置文件并重新开始

Python/Patchright问题：

• 检查Python版本：python --version（应为3.12及以上）
• 重新安装Patchright：uv run patchright install chromium
• 重新安装依赖项：uv sync --reinstall

超时问题：

• 如果页面无法加载或找不到元素，尝试增加超时时间：--timeout 10000
• 对于网络较慢的用户，可能需要更高的值（例如15000-30000毫秒）
• 也可以通过环境变量设置：TIMEOUT=10000

自定义Chrome路径：

• 如果Chrome安装在非标准位置，使用 --chrome-path /path/to/chrome
• 也可以通过环境变量设置：CHROME_PATH=/path/to/chrome