HDW MCP 服务器

一个模型上下文协议（MCP）服务器，通过使用HorizonDataWave API提供对LinkedIn数据和功能的全面访问，不仅支持数据检索，还支持强大的用户账户管理。

功能

• LinkedIn 用户搜索： 通过关键词、姓名、职位、公司、地点、行业和教育背景筛选和搜索LinkedIn用户。

• 个人资料查询： 获取LinkedIn用户的详细个人资料信息。

• 邮箱查询： 通过电子邮件地址查找LinkedIn用户详情。

• 帖子与反应： 获取用户的帖子及其相关反应。

• 帖子转发与评论： 获取特定LinkedIn帖子的转发和评论。

• 账户管理：

  • 聊天功能： 通过LinkedIn管理API接收和发送聊天消息。
  • 联系人管理： 向LinkedIn用户发送联系请求。
  • 帖子评论： 在LinkedIn帖子或回复上创建评论。
  • 用户联系人： 获取用户的LinkedIn联系人列表。

• 公司搜索与详情：

  • Google 公司搜索： 使用Google搜索查找LinkedIn公司——通常第一个结果是最匹配的。
  • 公司查询： 获取关于LinkedIn公司的详细信息。
  • 公司员工： 获取给定LinkedIn公司的员工列表。

• Google 搜索

工具

HDW MCP 服务器通过MCP协议暴露了几个工具。每个工具都定义了名称、描述和输入参数：

1. Search LinkedIn Users
   Name: search_linkedin_users
   Description: Search for LinkedIn users with various filters.
   Parameters:

   • keywords (optional): Any keyword for search.
   • first_name, last_name, title, company_keywords, school_keywords (optional).
   • current_company, past_company, location, industry, education (optional).
   • count (optional, default: 10): Maximum number of results (max 1000).
   • timeout (optional, default: 300): Timeout in seconds (20–1500).

2. Get LinkedIn Profile
   Name: get_linkedin_profile
   Description: Retrieve detailed profile information about a LinkedIn user.
   Parameters:

   • user (required): User alias, URL, or URN.
   • with_experience, with_education, with_skills (optional, default: true).

3. Get LinkedIn Email User
   Name: get_linkedin_email_user
   Description: Look up LinkedIn user details by email.
   Parameters:

   • email (required): Email address.
   • count (optional, default: 5).
   • timeout (optional, default: 300).

4. Get LinkedIn User Posts
   Name: get_linkedin_user_posts
   Description: Retrieve posts for a LinkedIn user by URN.
   Parameters:

   • urn (required): User URN (must include prefix, e.g. fsd_profile:...).
   • count (optional, default: 10).
   • timeout (optional, default: 300).

5. Get LinkedIn User Reactions
   Name: get_linkedin_user_reactions
   Description: Retrieve reactions for a LinkedIn user by URN.
   Parameters:

   • urn (required).
   • count (optional, default: 10).
   • timeout (optional, default: 300).

6. Get LinkedIn Chat Messages
   Name: get_linkedin_chat_messages
   Description: Retrieve top chat messages from the LinkedIn management API.
   Parameters:

   • user (required): User URN (with prefix).
   • count (optional, default: 20).
   • timeout (optional, default: 300).

7. Send LinkedIn Chat Message
   Name: send_linkedin_chat_message
   Description: Send a chat message using the LinkedIn management API.
   Parameters:

   • user (required): Recipient user URN (with prefix).
   • text (required): Message text.
   • timeout (optional, default: 300).

8. Send LinkedIn Connection Request
   Name: send_linkedin_connection
   Description: Send a connection invitation to a LinkedIn user.
   Parameters:

   • user (required).
   • timeout (optional, default: 300).

9. Send LinkedIn Post Comment
   Name: send_linkedin_post_comment
   Description: Create a comment on a LinkedIn post or reply.
   Parameters:

   • text (required): Comment text.
   • urn (required): Activity or comment URN.
   • timeout (optional, default: 300).

10. Get LinkedIn User Connections
    Name: get_linkedin_user_connections
    Description: Retrieve a list of LinkedIn user connections.
    Parameters:

    • connected_after (optional): Timestamp filter.
    • count (optional, default: 20).
    • timeout (optional, default: 300).

11. Get LinkedIn Post Reposts
    Name: get_linkedin_post_reposts
    Description: Retrieve reposts for a LinkedIn post.
    Parameters:

    • urn (required): Post URN (must start with activity:).
    • count (optional, default: 10).
    • timeout (optional, default: 300).

12. Get LinkedIn Post Comments
    Name: get_linkedin_post_comments
    Description: Retrieve comments for a LinkedIn post.
    Parameters:

    • urn (required).
    • sort (optional, default: "relevance"; allowed values: "relevance", "recent").
    • count (optional, default: 10).
    • timeout (optional, default: 300).

13. Get LinkedIn Google Company
    Name: get_linkedin_google_company
    Description: Search for LinkedIn companies via Google – the first result is typically the best match.
    Parameters:

    • keywords (required): Array of company keywords.
    • with_urn (optional, default: false).
    • count_per_keyword (optional, default: 1; range 1–10).
    • timeout (optional, default: 300).

14. Get LinkedIn Company
    Name: get_linkedin_company
    Description: Retrieve detailed information about a LinkedIn company.
    Parameters:

    • company (required): Company alias, URL, or URN.
    • timeout (optional, default: 300).

15. Get LinkedIn Company Employees
    Name: get_linkedin_company_employees
    Description: Retrieve employees of a LinkedIn company.
    Parameters:

    • companies (required): Array of company URNs.
    • keywords, first_name, last_name (optional).
    • count (optional, default: 10).
    • timeout (optional, default: 300).

设置指南

1. 克隆仓库 (macOS)

打开终端并运行以下命令：

# Clone the repository
git clone https://github.com/horizondatawave/hdw-mcp-server.git

# Change directory to the project folder
cd hdw-mcp-server

# Install dependencies
npm install

2. 获取您的 API 凭证

在 app.horizondatawave.ai 注册以获取您的 API 密钥和 100 个免费积分。您将收到 HDW_ACCESS_TOKEN 和 HDW_ACCOUNT_ID。

3. 配置环境

在项目的根目录下创建一个 .env 文件，内容如下：

HDW_ACCESS_TOKEN=YOUR_HD_W_ACCESS_TOKEN
HDW_ACCOUNT_ID=YOUR_HD_W_ACCOUNT_ID

4. 客户端配置

4.1 Claude 桌面版

更新您的 Claude 配置文件 (claude_desktop_config.json)，内容如下：

{
  "mcpServers": {
    "hdw": {
      "command": "npx",
      "args": ["@horizondatawave/mcp"],
      "env": {
        "HDW_ACCESS_TOKEN": "YOUR_HD_W_ACCESS_TOKEN",
        "HDW_ACCOUNT_ID": "YOUR_HD_W_ACCOUNT_ID"
      }
    }
  }
}

配置文件位置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

4.2 Cursor

简便方法：
打开 Cursor 设置并使用以下命令添加一个新的 MCP 服务器：

env HDW_ACCESS_TOKEN=your-access-token HDW_ACCOUNT_ID=your-account-id node /path/to/your/build/index.js

安全方法：
将提供的模板 run.template.sh 复制到一个新文件（例如 run.sh），用您的凭证更新它，并配置 Cursor 运行：

sh /path/to/your/run.sh

4.3 Windsurf

更新您的 Windsurf 配置文件 (mcp_config.json)，内容如下：

{
  "mcpServers": {
    "hdw": {
      "command": "node",
      "args": ["/path/to/your/build/index.js"],
      "env": {
        "HDW_ACCESS_TOKEN": "YOUR_HD_W_ACCESS_TOKEN",
        "HDW_ACCOUNT_ID": "YOUR_HD_W_ACCOUNT_ID"
      }
    }
  }
}

注意： 配置完成后，您可以禁用官方 Web 工具以节省您的 API 积分。

MCP 客户端示例配置

以下是一个 MCP 客户端（例如自定义集成）的示例配置：

{
  "mcpServers": {
    "hdw": {
      "command": "npx",
      "args": ["@horizondatawave/mcp"],
      "env": {
        "HDW_ACCESS_TOKEN": "YOUR_HD_W_ACCESS_TOKEN",
        "HDW_ACCOUNT_ID": "YOUR_HD_W_ACCOUNT_ID"
      }
    }
  }
}

请用自己的路径和凭证替换这些值。

许可证

本项目根据 MIT 许可证发布。