LinkedIn MCP Server

• 默认（stdio）：本地 MCP 服务的标准通信方式
• Streamable HTTP：用于基于 Web 的 MCP 服务
• 如果未指定传输方式，服务默认使用 stdio
• 在未显式指定传输方式的交互式终端中，会显示选择提示

会话：

• --login - 打开浏览器进行登录并保存会话
• --import-from-browser [BROWSER] - 重用本地已登录的 Chromium 浏览器会话（chrome、chromium、brave、edge、arc、vivaldi、helium、yandex、whale、coccoc、opera、opera_gx、auto）。单独使用此标志时会选择 auto，即最近使用且拥有有效 LinkedIn 会话的浏览器。
• --auto-import / --no-auto-import - 在首次需要会话的工具调用时，从本地已登录的浏览器导入会话，再回退到手动登录（默认：开启）。在 Docker、使用代理或绑定非回环 HTTP 地址时会跳过。在 macOS 上，钥匙串可能会提示一次。
• --logout - 清除保存的会话
• --login-viewer - 仅限 Docker：在受令牌保护的端口 6080 URL 上显示 --login 浏览器（参见身份验证）
• --user-data-dir PATH - 浏览器配置目录（默认：~/.linkedin-mcp/profile）。轮换或清除会话时，会删除此目录及其父目录，后者存放已保存的 Cookie 和派生配置文件。
• --claim-profile-root - 接管服务不会自行认领的配置目录，例如其父目录中已有其他文件的目录。每个目录只需执行一次。

传输方式：

• --transport {stdio,streamable-http} - 强制指定传输模式（默认：stdio）
• --host HOST / --port PORT / --path PATH - HTTP 服务地址（默认：127.0.0.1、8000、/mcp）

超时：

• --timeout MS - 单次页面操作的超时时间（默认：5000）
• --tool-timeout SECONDS - 整个工具调用的超时时间（默认：180）。对于需要读取许多页面、网络较慢或浏览器冷启动的调用，请调高此值。
• --login-timeout SECONDS - 登录浏览器等待你完成登录的时长（默认：1800；0 = 不限时）。无论如何，--login-viewer 都会在 30 分钟后结束会话。
• --login-inline-wait SECONDS - 工具调用等待登录完成后再提示模型重试的时长（默认：25，最大：45；0 = 立即返回）

共享浏览器：

• --browser-wait SECONDS - 等待另一个服务进程移交共享浏览器的时长（默认：25，最大：45；0 = 立即报告繁忙）。仅在同时运行多个 MCP 客户端时有效。
• --browser-min-hold SECONDS - 此进程移交共享浏览器前至少保留它的时长（默认：20）。此值会限制在比 --browser-wait 少 3 秒以内，因此调高此值时也要调高后者。值越大，浏览器重启次数越少，但其他客户端的等待时间越长。
• --browser-idle-timeout SECONDS - 无工具调用达到此时长后，关闭空闲浏览器并释放配置文件（默认：600；0 = 保持打开）

浏览器：

• --no-headless - 显示浏览器窗口（便于调试）
• --chrome-path PATH - Chrome/Chromium 可执行文件的路径
• --proxy-server URL - 通过代理转发浏览器流量，格式为 scheme://host:port。请在 --login 之前完成配置；参见使用代理。

其他：

• --log-level {DEBUG,INFO,WARNING,ERROR} - 日志级别（默认：WARNING）

如果你已在 Chrome、Chromium、Brave、Edge、Arc、Vivaldi、Helium、Yandex、Naver Whale、Cốc Cốc、Opera 或 Opera GX 中登录 LinkedIn，可以跳过手动执行 --login 的步骤，直接重用该会话：

# Auto-pick the most recently used browser with a live LinkedIn session
uvx mcp-server-linkedin@latest --import-from-browser
# Or target a specific browser
uvx mcp-server-linkedin@latest --import-from-browser brave

此操作会读取浏览器中的 LinkedIn Cookie，通过你的动态消息验证 Cookie，并将其保存到 ~/.linkedin-mcp/profile/，与 --login 保存的位置相同。注意：

• 如果登录了多个浏览器，会优先尝试最近使用的有效 LinkedIn 会话。如果 LinkedIn 拒绝该会话（已撤销或已从远程退出登录），则会自动尝试下一个最近使用的会话；服务器接受的第一个会话会被导入。系统不会提示你选择。传入浏览器名称即可指定某个浏览器。
• 在 macOS 上，系统钥匙串可能会提示是否允许访问浏览器的 Safe Storage。为确保读取可靠，请先关闭源浏览器。
• Chrome 127+ 使用应用绑定加密（v20）保护的 Cookie 无法在不提升系统权限的情况下解密；此时请改用 --login。
• 导入的 Cookie 与真实登录后磁盘上的 Cookie 集合一致。本地服务器会从已保存的配置文件中完整读取这些 Cookie；Docker 桥接会将其缩减为正常会话所用的同一最小身份验证子集。

基本用法示例：

# Run with debug logging
uvx mcp-server-linkedin@latest --log-level DEBUG

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

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

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

工具调用会被串行化，以保护共享的 LinkedIn 浏览器会话；无论是在单个服务器进程内，还是在多个独立进程之间，都是如此。如果你同时运行多个 MCP 客户端，每个客户端都会启动自己的服务器进程，但同一时间只有一个客户端能使用浏览器；其他客户端会短暂等待，并在当前调用结束后立即接管。等待时间过长的客户端会收到“浏览器正忙”消息，此时只需重试即可。使用 --log-level DEBUG 查看等待／获取／释放日志。

此机制适用于同一台计算机和同一运行环境中的进程。它不适用于共享同一个 ~/.linkedin-mcp 目录的主机和 Docker 容器之间的进程，因此，在容器运行期间，请勿在主机上运行 --login 或 --logout。

使用 mcp inspector 测试：

1. 安装并运行 mcp inspector：bunx @modelcontextprotocol/inspector
2. 点击预填充的令牌 URL，在浏览器中打开 inspector
3. 将 Transport Type 选择为 Streamable 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 默认的 30s HTTP 超时时间可能过短。上方推荐的配置已设置 UV_HTTP_TIMEOUT=300（秒）以避免此问题。
• Windows，DLL load failed while importing _greenlet：请升级到 greenlet 3.5.5 或更高版本；这些版本发布的 Windows wheel 会再次将 C++ 运行时包含在扩展中。重新运行 uvx 即可自动解决此问题；如果环境锁定了依赖项，则需要运行 uv lock --upgrade-package greenlet。只有 greenlet 3.3.1 到 3.5.4 需要 MSVCP140.dll，而 python.org 安装程序和由 uv 管理的构建都不包含该 DLL；从源代码构建的 greenlet 则可能在任何版本中都需要它。如果无法升级版本，Microsoft Visual C++ Redistributable 可提供该 DLL。相关问题见 greenlet#525，并已在 greenlet#526 中修复。

• 确保同一时间只登录一个 LinkedIn 会话
• 使用 --login 时，LinkedIn 可能会要求你在 LinkedIn 移动应用中确认登录
• 登录期间，LinkedIn 可能会显示验证码挑战。运行 uvx mcp-server-linkedin@latest --login，它会打开一个浏览器，你可以在其中手动完成验证。

• 页面操作失败（找不到元素、导航卡住）：增大浏览器页面操作超时时间：--timeout 10000 或 TIMEOUT=10000（毫秒，默认值为 5000）。
• 整个工具调用超时（例如，多分区个人资料、冷启动 Chromium、运行缓慢的容器）：增大每个工具的执行超时时间：--tool-timeout 300 或 TOOL_TIMEOUT=300（秒，默认值为 180）。
• 没有会话时的首次工具调用：如果本地已登录的浏览器中存在有效的 LinkedIn 会话，服务会自动导入该会话（参见 AUTO_IMPORT_FROM_BROWSER / --auto-import），而不是强制要求手动登录。在 macOS 上，系统可能会提示你一次，要求授权访问 Safe Storage。如果不存在可导入的浏览器会话，服务会改为打开登录窗口，并等待最多 LOGIN_INLINE_WAIT 秒（默认值为 25，最大值为 45；--login-inline-wait），这样快速登录即可在一次调用中完成。如果等待时间结束，工具会返回待处理信号，模型会在约 30 秒后重试。在 Docker 环境下，或服务绑定到非回环 HTTP 主机时，自动导入和内联等待均不会生效。请在主机上使用 --login 创建会话，或使用 Docker 专用的 --login --login-viewer 命令。
• 网络连接较慢的用户可能需要调高上述任一超时值。

• 如果工具调用在非容器环境的机器上返回“Docker 中没有可用的 LinkedIn 会话”，则说明运行环境检测有误。这种情况曾发生在运行 Docker 守护进程以提供其他服务的 Linux 主机上。设置 LINKEDIN_MCP_CONTAINER=false 可覆盖检测结果；设置为 true 则会强制采用相反的检测结果。

• Claude Desktop 会立即启动该捆绑包；浏览器设置会在后台继续进行
• 如果 Patchright Chromium 浏览器仍在下载，请稍等片刻后重试工具
• 托管的浏览器下载内容会共享存放在 ~/.linkedin-mcp/patchright-browsers/ 下
• 浏览器缓存不断增大：只要仍有任何已安装版本引用旧版 Chromium，Patchright 就会保留该版本，因此升级后磁盘上可能同时存在多个版本。服务器日志会发出警告，指出它保留了哪些内容。要释放空间，请停止所有 LinkedIn MCP Server 实例，删除 ~/.linkedin-mcp/patchright-browsers/，然后在下次启动时下载当前浏览器。
• Windows 上，捆绑包因 DLL load failed while importing _greenlet 退出：请安装 Microsoft Visual C++ Redistributable，或重新安装固定使用 greenlet 3.5.5 或更高版本的捆绑包；这些版本发布的 Windows wheel 会再次将 C++ 运行时包含在扩展中。固定使用 greenlet 3.3.1 至 3.5.4 的捆绑包需要该可再发行组件提供的 MSVCP140.dll，而 python.org 安装程序和由 uv 管理的构建都不包含此 DLL；从源码构建的 greenlet 在任何版本中都可能需要它。服务器会在启动时自行指出这一问题，并且只有在确认加载器无法提供该 DLL 后才会提示。此问题已在 greenlet#525 中报告，并在 greenlet#526 中修复。

• 确保同一时间只有一个活跃的 LinkedIn 会话
• 使用 --login 时，LinkedIn 可能要求你在 LinkedIn 移动应用中确认登录
• 登录期间，LinkedIn 可能会显示验证码挑战。运行 uvx mcp-server-linkedin@latest --login，这会打开一个浏览器，你可以在其中手动完成验证码。先决条件请参阅 uvx 设置。

• 页面操作失败（未找到元素、导航卡住）：增大浏览器页面操作超时时间：--timeout 10000 或 TIMEOUT=10000（毫秒，默认值为 5000）。
• 整个工具调用超时（例如，多部分个人资料、Chromium 冷启动、容器运行缓慢）：增大每个工具的执行超时时间：--tool-timeout 300 或 TOOL_TIMEOUT=300（秒，默认值为 180）。
• 首次调用工具时没有会话：如果本地已登录的浏览器中有有效的 LinkedIn 会话，服务器会自动导入该会话（参见 AUTO_IMPORT_FROM_BROWSER / --auto-import），而不是强制要求手动登录。在 macOS 上，钥匙串可能会提示一次，要求访问安全存储。如果没有可导入的浏览器会话，服务器会改为打开登录窗口，并等待最多 LOGIN_INLINE_WAIT 秒（默认值为 25，最大值为 45；--login-inline-wait），以便快速登录后通过一次调用完成操作。如果等待时间结束，工具会返回待处理信号，模型会在约 30 秒后重试。在 Docker 环境下，或服务器绑定到非环回 HTTP 主机时，自动导入和内嵌等待均不适用。请在主机上使用 --login 创建会话，或使用明确的 Docker --login --login-viewer 命令。
• 网络连接较慢的用户可能需要提高上述任一参数的值。

• 如果工具调用返回“Docker 中没有可用的有效 LinkedIn 会话”，但你的机器并非容器，则说明运行环境检测有误。这种情况曾发生在运行 Docker 守护进程以提供无关服务的 Linux 主机上。设置 LINKEDIN_MCP_CONTAINER=false 可覆盖检测结果；设置为 true 则会强制使用相反结果。

会话：

• --login - 打开浏览器登录并保存会话
• --import-from-browser [BROWSER] - 重用本地已登录的 Chromium 浏览器会话（chrome、chromium、brave、edge、arc、vivaldi、helium、yandex、whale、coccoc、opera、opera_gx、auto）。单独使用该选项时会选择 auto，即最近使用且拥有有效 LinkedIn 会话的浏览器。
• --auto-import / --no-auto-import - 在首次需要会话的工具调用时，从已登录的本地浏览器导入会话，然后再回退到手动登录（默认：开启）。在 Docker、使用代理以及 HTTP 绑定地址非回环地址时会跳过。在 macOS 上，钥匙串可能会提示一次。
• --status - 检查已存储的会话是否有效，然后退出
• --logout - 清除已存储的会话
• --user-data-dir PATH - 浏览器配置目录（默认：~/.linkedin-mcp/profile）。轮换或清除会话时会删除此目录及其父目录，其中保存着 Cookie 和派生配置文件。
• --claim-profile-root - 接管服务不会自动认领的配置目录，例如其父目录中已有其他文件的目录。每个目录只需执行一次。

传输：

• --transport {stdio,streamable-http} - 强制指定传输模式（默认：stdio）
• --host HOST / --port PORT / --path PATH - HTTP 服务地址（默认值：127.0.0.1、8000、/mcp）

超时：

• --timeout MS - 单个页面操作的超时时间（默认值：5000）
• --tool-timeout SECONDS - 整个工具调用的超时时间（默认值：180）。如果调用会读取很多页面、网络较慢或浏览器处于冷启动状态，请调高此值。
• --login-timeout SECONDS - 登录浏览器等待你完成登录的时长（默认值：1800；0 = 不限时）。无论如何，--login-viewer 都会在 30 分钟后结束会话。
• --login-inline-wait SECONDS - 工具调用等待登录完成、然后提示模型重试的时长（默认值：25，最大值：45；0 = 立即返回）

共享浏览器：

• --browser-wait SECONDS - 等待其他服务进程移交共享浏览器的时长（默认值：25，最大值：45；0 = 立即报告浏览器正忙）。仅在多个 MCP 客户端同时运行时生效。
• --browser-min-hold SECONDS - 此进程移交共享浏览器前保留浏览器的最短时长（默认值：20）。此值会限制在比 --browser-wait 少 3 秒以内，因此调高此值时也要相应调高前者。值越高，浏览器重启次数越少，但其他客户端的等待时间越长。
• --browser-idle-timeout SECONDS - 在这么长时间没有工具调用后，关闭空闲浏览器并释放配置文件（默认值：600；0 = 保持开启）

浏览器：

• --no-headless - 显示浏览器窗口（便于调试）
• --slow-mo MS - 浏览器操作之间的延迟（默认值：0，便于调试）
• --viewport WxH - 视口尺寸（默认值：1280x720）。仅适用于无窗口模式；有窗口启动时使用实际窗口尺寸。
• --chrome-path PATH - Chrome/Chromium 可执行文件的路径
• --installer-temp-dir PATH - 浏览器安装临时文件所在的现有目录（环境变量：INSTALLER_TEMP_DIR）。
• --proxy-server URL - 通过代理转发浏览器流量，格式为 scheme://host:port。请在 --login 之前设置；参见使用代理。

其他：

• --log-level {DEBUG,INFO,WARNING,ERROR} - 日志级别（默认值：WARNING）
• --help - 显示帮助

注意： 大多数 CLI 选项都有对应的环境变量。详情请参阅 .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": {
    "mcp-server-linkedin": {
      "command": "uv",
      "args": ["--directory", "/path/to/linkedin-mcp-server", "run", "-m", "linkedin_mcp_server"]
    }
  }
}

此配置默认使用 stdio。

• 确保同一时间只有一个活跃的 LinkedIn 会话
• 使用 --login 时，LinkedIn 可能要求你在 LinkedIn 移动应用中确认登录
• 登录期间，LinkedIn 可能会显示验证码挑战。--login 命令会打开浏览器，你可以在其中手动完成验证。

• 如果工具返回的数据有误或缺失，请使用 --no-headless 观察浏览器
• 添加 --log-level DEBUG 以查看更详细的日志

• 浏览器配置文件存储在 ~/.linkedin-mcp/profile/
• 受管理的浏览器下载文件缓存在 ~/.linkedin-mcp/patchright-browsers/，并由 uvx 和 MCP Bundle 安装共享
• 浏览器缓存不断增大：只要已安装的任何版本仍引用旧版 Chromium，Patchright 就会保留该版本；uv 归档或另一个工作树都可能构成此类引用。服务会记录一条警告，指出占用缓存的对象。若要释放空间，请停止所有 LinkedIn MCP Server 实例，删除 ~/.linkedin-mcp/patchright-browsers/，然后让下次启动下载当前浏览器。
• 使用 --logout 清除配置文件并重新开始

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

• 如果工具调用在一台并非容器的机器上返回“Docker 中没有有效的 LinkedIn 会话”，则运行时检测有误。这种情况曾发生在运行 Docker 守护进程以提供其他服务的 Linux 主机上。设置 LINKEDIN_MCP_CONTAINER=false 可覆盖检测结果；设置为 true 则会强制采用相反的结果。

• 如果 Chrome 安装在非标准位置，请使用 --chrome-path /path/to/chrome
• 也可以通过环境变量设置：CHROME_PATH=/path/to/chrome
• 在 macOS 和 Linux 上，浏览器版本必须不低于上次打开你的个人资料时使用的版本，否则服务会拒绝启动。（Windows 上不会进行此检查：在那里无法在不启动浏览器的情况下查询其版本。）较旧的浏览器可能会悄悄丢弃由较新浏览器写入的数据，其中包括已保存的会话，导致的问题看起来与登录过期完全相同。提示信息会显示两个版本。使用较新版本的 Chrome 运行过一次后，通常只需再次运行那个较新的浏览器，或运行 --login；后者会将已存储的会话移至一旁，并使用你当前的浏览器重新登录。--logout 也会清除会话，但会丢弃旧会话，而不会保留以供恢复；它还会要求在终端中确认，因此无法用于由 MCP 客户端启动的服务端。
• 此版本比较仅适用于 Chrome、Chromium 和 Chrome for Testing。其他衍生浏览器的版本号规则各不相同（Vivaldi 使用 7.x，Edge 的构建号在相同主版本下远低于 Chrome），因此将 CHROME_PATH 指向这类浏览器会关闭版本检查，而不是导致无法通过的拒绝启动。