LinkedInMCP: Revolutionizing LinkedIn API Interactions

LinkedInMCP：革新 LinkedIn API 交互方式

🚀 全面的设置指南

前提条件

• Node.js 16+
• LinkedIn 开发者帐户
• 兼容 MCP 的大模型（Claude、OpenAI 等）

⚠️ LinkedIn API 访问限制（请先阅读）

此 MCP 服务会调用 LinkedIn 的官方 HTTP API。用户遇到的几个问题源于 LinkedIn 产品 / 合作伙伴限制，而非安装步骤中的错误：

1. 大多数开发者应用无法使用 client_credentials（双向 OAuth）。
   LinkedIn 文档指出，应用默认无法获取应用令牌。普通应用提交 grant_type=client_credentials 通常会收到以下错误： access_denied / "This application is not allowed to create application tokens"。
   此流程仅适用于获批的 LinkedIn 企业 / 合作伙伴产品。通常需要联系 LinkedIn 客户关系经理或业务拓展联系人，或者改用成员的授权码（三方）流程。请参阅 客户端凭据流程（双向 OAuth）。

2. 没有公开的通用 /search/people 人员搜索端点。
   LinkedIn 未为普通开发者应用提供免费的、不受限制的“按关键词 / 公司 / 地点搜索任意成员” API。此仓库中的 search-people 工具目前调用 /v2/search/people，这是一个未公开记录的端点，无法通过标准开发者令牌使用。
   LinkedIn 目前公开记录的是有限的个人资料 / 人员 API（主要用于已认证的成员），以及受限的 People Typeahead API，用于组织主页上搜索并 @mention 主页关注者（文档）。更广泛的人员搜索需要相应的 LinkedIn 合作伙伴产品（例如 Talent / Sales）。在此服务更新为使用有公开文档的端点之前，请将 search-people 视为实验性 / 仅限合作伙伴使用的工具。

3. 在 POST 请求正文中发送凭据，切勿放在 URL 中。
   令牌请求现在使用 Content-Type: application/x-www-form-urlencoded，并在正文中传递 client_id / client_secret，符合 LinkedIn 的 OAuth 指南，因此机密信息不会附加为查询参数。

1. LinkedIn 开发者设置

1. 前往 LinkedIn 开发者门户
2. 创建新应用
3. 获取 Client ID 和 Client Secret

重要提示： 有关获取访问令牌及 LinkedIn API 身份验证的详细说明，请参阅官方文档：获取 LinkedIn API 访问权限

2. 项目安装

git clone https://github.com/Dishant27/linkedin-mcp-server.git
cd linkedin-mcp-server
npm install

3. 配置文件

.env 文件

在项目根目录中创建 .env 文件：

LINKEDIN_CLIENT_ID=your_client_id_here
LINKEDIN_CLIENT_SECRET=your_client_secret_here

claude_desktop_config.json（用于 Claude Desktop）

{
  "mcpServers": {
    "linkedin": {
      "command": "node",
      "args": ["/absolute/path/to/linkedin-mcp-server/dist/index.js"],
      "env": {
        "LINKEDIN_CLIENT_ID": "your_client_id",
        "LINKEDIN_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

4. 大模型配置示例

Claude.ai / Claude Desktop MCP 集成

{
  "tools": [
    {
      "name": "search-people",
      "description": "Search for LinkedIn profiles",
      "parameters": {
        "type": "object",
        "properties": {
          "keywords": {
            "type": "string",
            "description": "Keywords to search for in profiles"
          },
          "currentCompany": {
            "type": "array",
            "items": {"type": "string"},
            "description": "Filter by current company"
          },
          "industries": {
            "type": "array",
            "items": {"type": "string"},
            "description": "Filter by industries"
          },
          "location": {
            "type": "string", 
            "description": "Filter by location"
          }
        }
      }
    },
    {
      "name": "get-profile",
      "description": "Retrieve detailed LinkedIn profile information",
      "parameters": {
        "type": "object",
        "properties": {
          "publicId": {
            "type": "string",
            "description": "Public ID of the LinkedIn profile"
          },
          "urnId": {
            "type": "string", 
            "description": "URN ID of the LinkedIn profile"
          }
        }
      }
    }
  ]
}

5. 典型工作流

1. 启动 MCP 服务：

npm run build
npm start

2. 大模型交互示例：

> Find software engineers in San Francisco working at tech companies

# The LLM will use the search-people tool to:
# 1. Search LinkedIn profiles
# 2. Filter by location (San Francisco)
# 3. Filter by industry (Technology)
# 4. Return relevant profile details

📖 了解更多

查看介绍此概念及其实现方式的详细文章：

面向大模型的 LinkedIn MCP 服务

🚀 项目背景

LinkedInMCP 是一款创新的模型上下文协议（MCP）服务，旨在改变开发者与 LinkedIn API 交互的方式。本项目旨在满足开发者对更灵活、更强大的 LinkedIn 数据集成方案的需求，提供稳健且可扩展的框架，以支持高级 LinkedIn 数据检索与交互。

🌟 项目愿景

认识到传统 LinkedIn API 方案的局限性，本方案打造了一种更智能、更注重上下文的专业社交网络数据处理方式。

✨ 主要创新

• 智能上下文管理：利用 MCP 的高级上下文处理能力
• 安全的类型化交互：与 LinkedIn API 进行类型安全的交互
• 可扩展架构：易于扩展和自定义
• 标准化协议：遵循 Model Context Protocol 规范

🛠️ 技术

• TypeScript
• Model Context Protocol
• LinkedIn API
• OAuth 2.0
• 用于类型验证的 Zod
• 用于 HTTP 请求的 Axios

🔍 核心能力

• 高级人物搜索
• 详细的个人资料检索
• 就业市场情报
• 消息功能
• 安全的身份验证工作流

💼 企业应用场景

LinkedInMCP 为企业环境中的强大应用提供支持：

人才招聘

• 候选人寻访：查找符合特定技能和经验条件的合格候选人
• 人才库分析：绘制各行业和地区的人才分布图
• 外联自动化：简化与潜在候选人的初次联系
• 竞争情报：了解竞争企业的招聘模式

销售与业务拓展

• 潜在客户开发：识别目标公司的决策者
• 基于客户的营销：为重要客户建立全面的资料
• 关系映射：可视化组织内的关系网络
• 市场渗透分析：跟踪各行业对产品或服务的采用情况

市场研究

• 行业趋势：监测各行业的就业变化
• 技能需求分析：跟踪新兴技能和技术
• 组织架构洞察：绘制汇报关系和团队构成图
• 地理流动模式：了解人才在不同地区间的迁移情况

集成能力

• CRM 同步：将 LinkedIn 联系人数据更新到 CRM 系统
• ATS 增强：利用 LinkedIn 数据丰富申请人跟踪系统
• 商业智能工具：将 LinkedIn 数据提供给仪表板和分析平台
• 自定义工作流集成：通过 API 将 LinkedIn 功能添加到内部工具中

🔒 安全框架

LinkedInMCP 的全面安全模型采用多层防护：

身份验证安全

• OAuth 2.0 实现：符合行业标准的基于令牌的身份验证
• 令牌刷新管理：自动处理令牌过期
• 凭据隔离：基于环境的机密管理
• 速率限制：防止过量 API 请求

数据安全

• 端到端加密：安全传输数据
• 最少数据存储：处理数据时不进行持久化存储
• 选择性返回信息：仅返回请求的数据字段
• 自动数据清理：防止注入漏洞

合规功能

• 遵循 GDPR：提供可配置的数据处理方式，以符合欧洲合规要求
• 落实 API 条款：内置 LinkedIn API 使用政策合规机制
• 审计日志：全面跟踪活动，支持合规报告
• 数据治理工具：简化法规合规管理

📦 生成的项目结构

linkedin-mcp-server/
│
├── src/
│   ├── index.ts         # Main server entry point
│   ├── auth.ts          # LinkedIn authentication handler
│   └── client.ts        # LinkedIn API interaction client
│
├── dist/                # Compiled JavaScript files
│   ├── index.js
│   ├── auth.js
│   └── client.js
│
├── .env                 # Secret environment variables
├── .env.example         # Template for environment variables
├── package.json         # Project dependencies and scripts
├── tsconfig.json        # TypeScript configuration
└── README.md            # Project documentation

🤝 贡献

受本项目启发？欢迎贡献！

1. Fork 仓库
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 发起 Pull Request

📄 许可证

基于 MIT License 发布。

---

免责声明：本项目是一项独立创新，与 LinkedIn 或 Microsoft 均无官方关联。