Harmonic MCP 服务器

这是一个提供访问 Harmonic.ai API 的 Model Context Protocol (MCP) 服务器，用于搜索公司和个人/专业人士。

功能

• 在 Harmonic 数据库中搜索公司
• 根据域名获取详细的公司信息
• 搜索个人/专业人士
• 根据ID获取详细的个人信息
• 包含所有依赖项的独立包

构建

安装依赖项：

npm install

构建服务器：

npm run build

这将在 dist/standalone/ 目录下创建一个包含所有依赖项的独立包。

使用与 Claude Desktop

1. 从 https://console.harmonic.ai/docs/dashboard 获取你的 Harmonic API 密钥

2. 将服务器添加到你的 Claude Desktop 配置中：

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "harmonic": {
      "command": "node",
      "args": ["/absolute/path/to/HarmonicMCPServer/dist/standalone/index.js"]
    }
  }
}

重要：

• 将 /absolute/path/to/HarmonicMCPServer 替换为你的项目实际路径
• 使用完整的 Node 路径（通过 which node 查找）
• 确保路径中没有空格或特殊字符

3. 重启 Claude Desktop

4. 在 Claude 中，首先设置你的 API 密钥：

使用 harmonic_set_api_key 工具并输入你的 API 密钥

5. 现在你可以使用 Harmonic 工具：

• harmonic_search_company_by_domain - 根据网站域名搜索公司
• harmonic_search_companies - 根据查询搜索公司
• harmonic_search_people - 搜索个人/专业人士
• harmonic_get_saved_search_results - 获取已保存搜索的结果
• harmonic_get_company_employees - 获取公司的所有在职员工

可用工具

harmonic_set_api_key

设置你的 Harmonic API 密钥以进行身份验证。

参数：

• api_key (必需)：你的 Harmonic API 密钥

harmonic_search_company_by_domain

根据公司的网站域名使用 POST 方法搜索公司。

参数：

• domain (必需)：公司的网站域名（例如，harmonic.ai）

harmonic_search_companies

根据查询使用 GET 方法搜索公司。

参数：

• query (必需)：公司的搜索查询
• size (可选)：返回的结果数量（默认：50）
• cursor (可选)：分页游标

harmonic_search_people

使用 GET 方法搜索个人/专业人士。

参数：

• query (必需)：个人的搜索查询
• size (可选)：返回的结果数量（默认：50）
• cursor (可选)：分页游标

harmonic_get_saved_search_results

获取已保存搜索的结果。

参数：

• search_id (必需)：已保存搜索的ID
• size (可选)：返回的结果数量（默认：50）
• cursor (可选)：分页游标

harmonic_get_company_employees

获取公司的所有在职员工。

参数：

• company_id (必需)：公司的ID
• size (可选)：返回的结果数量（默认：50）
• cursor (可选)：分页游标

开发

在开发模式下运行：

npm run dev

API 文档

有关 Harmonic API 的更多信息，请访问： https://console.harmonic.ai/docs/api-reference/introduction