linkedin-mcp-server

环境要求

• 已安装 uv（uvx 随 uv 一起提供，README 要求先安装 uv）
• 一个支持 MCP 的客户端，如 Claude Desktop 等
• 可正常访问 LinkedIn 的网络环境，以及可登录的 LinkedIn 账号
• 若复用已有会话：本机已登录 LinkedIn 的 Chrome/Chromium/Brave/Edge/Arc/Vivaldi/Helium/Yandex/Wh

安装与启动步骤

1. 1安装 uv

   按 uv 官方安装文档安装 uv，安装后即拥有 uvx 命令，用于运行本项目，无需手动建虚拟环境。

2. 2写入客户端配置

   在 MCP 客户端配置文件中加入 mcpServers 段，用 uvx 拉起 mcp-server-linkedin 最新版并放宽下载超时。

   {
     "mcpServers": {
       "mcp-server-linkedin": {
         "command": "uvx",
         "args": ["mcp-server-linkedin@latest"],
         "env": { "UV_HTTP_TIMEOUT": "300" }
       }
     }
   }

   复制

3. 3首次登录 LinkedIn

   首次调用需要认证的工具时，服务器会打开浏览器登录窗口；也可用此命令显式登录并保存会话。

   uvx mcp-server-linkedin@latest --login

   复制

4. 4复用浏览器会话

   若本机浏览器已登录 LinkedIn，可跳过手动登录直接复用会话；不带参数时自动挑选最近使用且已登录的浏览器。

   uvx mcp-server-linkedin@latest --import-from-browser chrome

   复制

5. 5调试与日志排查

   遇到问题时用 DEBUG 级别日志启动，查看浏览器与工具调用细节，便于定位登录或抓取失败原因。

   uvx mcp-server-linkedin@latest --log-level DEBUG

   复制

6. 6HTTP 模式启动

   面向 Web 类 MCP 客户端时改用 streamable-http 传输，指定监听地址、端口与路径，默认则是 stdio。

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

   复制

7. 7退出并清理会话

   清除已保存的登录会话，轮换或清空会话时会删除浏览器 profile 目录及其父目录中的 Cookie。

   uvx mcp-server-linkedin@latest --logout

   复制

关键配置

如何确认成功

首次调用工具时会弹出 LinkedIn 登录窗口，登录完成后工具能返回数据；运行日志由 FastMCP/Uvicorn 输出。

常见问题

注意事项

• 首次工具调用可能先返回设置/认证进行中的提示，等待浏览器准备或登录完成即可正常使用。
• 配置里的 @latest 会开启自动更新，能跟上 LinkedIn 页面结构变化；若由 AI 智能体代改配置，建议先向用户确认。
• 命令行选项很多，但绝大多数有默认值：默认 stdio、127.0.0.1:8000、路径 /mcp、页面超时 5000ms、工具调用 180s。
• 使用代理必须在执行 --login 之前设置好 --proxy-server，否则登录与后续抓取可能失败。