LinkedIn Sales Navigator MCP Server
- 项目简介
- 本仓库实现了一个基于 MCP（Model Context Protocol）的后端服务器，用于向 LLM 客户端提供上下文信息与功能。核心能力包括对资源的托管与访问、工具的注册与执行、以及对 Prompt 模板的渲染等，全部通过 JSON-RPC 协议进行通信。服务器使用 Node.js/TypeScript 实现，提供了标准 MCP 服务端框架和一组针对 LinkedIn Sales Navigator 的工具。
- 主要功能点
- MCP 服务端实现与标准传输支持：通过 stdio 传输实现 MCP 服务器，可配合 Claude Desktop/Code 等客户端接入。
- 工具注册与执行：在 MCP 服务器中注册一系列工具，如会话验证、获取个人/他人资料、搜索、就业信息、公司信息、消息/连接管理等，供客户端调用。
- 资源与缓存：内置本地缓存（文件系统缓存）以降低重复请求，提高性能。
- LinkedIn 数据访问能力：通过 HTTP 请求与真实浏览器（Playwright）实现的组合方案，支持在有登录会话的前提下获取 LinkedIn 的数据、潜在的 Sales Navigator 功能。
- 规模化请求控制与抗速率限制：内置节流、重试与速率限制逻辑，确保在需要时稳定执行并在超限时给出明确提示。
- 安全合规提示：在使用前提供免责声明与合规注意事项，告知用户自动化访问 LinkedIn 的风险。
- 安装步骤（简要）
- 安装 Node.js 18+。
- 运行 npm install，随后 npm run build 以生成 dist/index.js。
- 配置环境变量 LI_AT_COOKIE（或 LINKEDIN_SESSION_COOKIE）以提供 LinkedIn 会话 cookie。
- 启动 MCP 服务器：node dist/index.js（通过 MCP 客户端连接该服务器）。
- 服务器配置（给 MCP 客户端的 JSON 配置示例说明）
- 服务器名称：linkedin-sales-navigator
- 启动命令与参数（用于 MCP 客户端连接）：command: "node"，args: ["/absolute/path/to/linkedin-sales-navigator-mcp/dist/index.js"]
- 环境变量示例（需在实际使用时替换为有效 Cookie 值）：
- { "server_name": "linkedin-sales-navigator", "command": "node", "args": ["/absolute/path/to/linkedin-sales-navigator-mcp/dist/index.js"], "env": { "LI_AT_COOKIE": "<your_li_at_cookie_here>" } }
- 注：MCP 客户端不需要代码实现，该配置用于告诉客户端如何启动并连接到 MCP 服务器。
- 基本使用方法
- 启动与连接
- 在服务端环境中构建并运行 MCP 服务器。
- 使用相应的 MCP 客户端（如 Claude Desktop/Code 等）按配置连接本服务器，确保 MCP 客户端能访问服务器的 stdio 接口。
- 调用工具
- 客户端通过 MCP 入口调用注册的工具，如 validate_session、get_profile、search_jobs、get_company 等，服务器按 JSON-RPC 约定返回结果。
- 安全与限制
- 依赖 LinkedIn 会话 Cookie，若 cookie 失效需更新并重启服务；并遵循速率限制与合规要求。
- 启动与连接