🏆 LinkedIn DI MCP 服务器

此服务器基于 模型上下文协议 (MCP)，允许 Claude 或任何其他兼容 MCP 的客户端与 Digital Intelligence LinkedIn Insight 服务进行交互。它提供创建和分析报告、获取洞察、类别和自动完成建议的工具。

⚠️ 免责声明

• 这是一个正在进行中的项目，因此配置在短期内可能会有所不同。
• 此服务器仅供官方 LinkedIn 帐户使用。
• 访问和刷新令牌包含敏感信息，应妥善保管。
• API 使用受 LinkedIn 服务条款和速率限制的约束。

---

🚀 前提条件

在使用此服务器之前，请确保您已具备：

• Node.js (v18 或更高版本)
• Claude 桌面应用程序
• 具有适当权限的 LinkedIn 帐户
• Auth0 身份验证 凭据

---

⚙️ 配置 Claude 桌面

1. 打开 Claude 桌面的配置文件：

   • MacOS:

     code ~/Library/Application\ Support/Claude/claude_desktop_config.json
     

   • Windows:

     code %AppData%\Claude\claude_desktop_config.json
     

2. 添加或更新以下配置：

   "mcpServers": {
     "di-linkedin": {
       "command": "/opt/homebrew/bin/node",
       "args": [
         "/ABSOLUTE/PATH/TO/YOUR/build/index.js"
       ]
     }
   }
   

3. 保存文件并重启 Claude 桌面。

🛠️ 可用工具

📌 get-linkedin-reports

描述: 检索经过身份验证的用户拥有的 LinkedIn 报告列表。

• 参数:

  • paginationStart (number, 可选): 分页起始索引
  • paginationEnd (number, 可选): 分页结束索引

• 响应:

  • JSON 格式的报告列表

---

📌 get-linkedin-report

描述: 获取有关特定 LinkedIn 报告的详细信息。

• 参数:

  • id (string): 要获取信息的报告的 ID

• 响应:

  • JSON 格式的完整报告详细信息

---

📌 create-linkedin-report

描述: 创建具有受众定义的新 LinkedIn 报告。

• 参数:

  • id (string): 报告 ID
  • title (string): 报告标题
  • audienceDefinition (object): 受众定义
  • baselineDefinition (object, 可选): 基线定义

• 响应:

  • 报告创建确认

---

📌 get-linkedin-insights

描述: 获取特定 LinkedIn 报告的洞察。

• 参数:

  • reportId (string): 要获取洞察的报告的 ID
  • facetUrns (array of strings, 可选): 按 facet URN 过滤洞察

• 响应:

  • JSON 格式的洞察数据

---

📌 get-linkedin-categories

描述: 获取特定 LinkedIn 报告的类别。

• 参数:

  • reportId (string): 要获取类别的报告的 ID
  • urns (array of strings, 可选): 按 URN 过滤类别

• 响应:

  • 类别数据，JSON 格式

---

📌 get-linkedin-typeahead

描述: 获取特定 facet 和查询的 LinkedIn 自动完成建议。使用此功能搜索公司、职位、技能等实体。

• 参数:

  • facet (string): facet URN (例如，urn:li:adTargetingFacet:employers)。使用 list-linkedin-typeahead-facets 工具查看可用 facet 的列表。
  • query (string, 可选): 用于按关键字过滤建议的搜索查询

• 响应:

  • JSON 格式的自动完成建议，包括每个建议的名称、URN 和 facet URN

• 使用示例:

  {
    "facet": "urn:li:adTargetingFacet:skills",
    "query": "javascript"
  }
  

---

📌 list-linkedin-typeahead-facets

描述: 列出可与 get-linkedin-typeahead 工具一起使用的所有可用 facet。每个 facet 代表您可以搜索的不同类型的实体。

• 参数: 无

• 响应:

  • 包含描述的所有可用 facet 的列表，包括：
    • locations (地理位置)
    • titles (当前职位)
    • employers (当前雇主)
    • skills (专业技能)
    • industries (行业)
    • 以及更多

---

📌 list-linkedin-facet-values

描述: 列出所有具有预定义值的 LinkedIn facet，或按特定 facet 过滤。此工具可帮助您发现可用于不使用自动完成系统的 facet 的确切值。

• 参数:

  • facet (string, 可选): 要获取值的特定 facet URN（例如，urn:li:adTargetingFacet:genders）。如果未提供，将列出所有具有预定义值的 facet。

• 响应:

  • 未指定 facet 时：包含预定义值的所有 facet 的完整列表，包括其描述和可能的值。
  • 指定 facet 时：有关指定 facet 的详细信息，包括所有可能的值和使用示例。

• 使用示例:

  {
    "facet": "urn:li:adTargetingFacet:genders"
  }
  

• 具有预定义值的可用 Facet:

  • genders (例如，"urn:li:gender:FEMALE", "urn:li:gender:MALE")
  • ageRanges (例如，"urn:li:ageRange:(18,24)", "urn:li:ageRange:(25,34)")
  • seniorities (例如，"urn:li:seniority:1" 表示 "入门级")
  • revenue (例如，"urn:li:revenue:(1,10)" 表示 "$1-10 百万")
  • 以及更多

---

📌 get-linkedin-account

描述: 获取 LinkedIn 帐户详细信息，包括 LinkedIn 令牌。

• 参数: 无

• 响应:

  • JSON 格式的帐户详细信息

---

📌 initiate-linkedin-device-auth

描述: 启动设备授权流程以获取用于身份验证的设备代码。

• 参数: 无

• 响应:

  • 设备授权详细信息和说明

🛠️ 故障排除

工具未出现在 Claude 中

1. 检查 Claude 桌面日志：

tail -f ~/Library/Logs/Claude/mcp*.log

2. 验证环境变量是否已正确设置。
3. 确保 index.js 的绝对路径正确。

身份验证问题

• 仔细检查 OAuth 凭据。
• 尝试使用 initiate-linkedin-device-auth 工具再次启动设备授权流程。
• 验证是否已启用所需的 API 范围。

📜 查看日志

要检查服务器日志：

对于 MacOS/Linux：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

对于 Windows：

Get-Content -Path "$env:AppData\Claude\Logs\mcp*.log" -Wait -Tail 20

🔐 安全注意事项

• 确保 API 凭据安全 – 切勿在公共存储库中公开它们。
• 使用环境变量来管理敏感数据。

📄 许可证

本项目根据 Apache 2.0 许可证获得许可。有关更多详细信息，请参见 LICENSE 文件。

🔐 身份验证

服务器使用 Auth0 设备授权流程进行身份验证：

1. 使用 initiate-linkedin-device-auth 工具启动授权流程
2. 按照说明在浏览器中完成授权
3. 服务器将自动处理令牌管理，包括在令牌过期时刷新令牌