AI导哈

人物公司数据丰富化工具

Clay.com MCP服务器提供人物和公司数据搜索与丰富化功能，适用于招聘、市场分析和商业智能等场景。

  • by bpw-civic
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 bpw-civic/clay-mcp-server

使用说明

Clay.com MCP服务器

用于Clay.com API集成的MCP（模型上下文协议）服务器，提供人员和公司丰富工具。

特性

  • 人员搜索和丰富：通过头衔、公司、行业、地点寻找和丰富人才
  • 公司搜索和丰富：按行业、技术、资金、规模查找和丰富公司
  • 粘土桌：列出、查询和浏览Clay工作区表

安装

npm install @civic-wisdom/clay-mcp

或者克隆并从源代码构建：

git clone https://github.com/bpw-civic/clay-mcp-server.git
cd clay-mcp-server
npm install
npm run build

配置

将Clay API密钥设置为环境变量：

export CLAY_API_KEY=your-api-key-here

用法

使用克劳德代码

添加到您的 .claude/settings.json 或 .mcp.json:

{
  "mcpServers": {
    "clay": {
      "command": "node",
      "args": ["node_modules/@civic-wisdom/clay-mcp/dist/index.js"],
      "env": {
        "CLAY_API_KEY": "${CLAY_API_KEY}"
      }
    }
  }
}

或者，如果从源代码安装：

{
  "mcpServers": {
    "clay": {
      "command": "node",
      "args": ["/path/to/clay-mcp-server/dist/index.js"],
      "env": {
        "CLAY_API_KEY": "${CLAY_API_KEY}"
      }
    }
  }
}

与其他MCP客户端

服务器通过stdio进行通信。从以下内容开始：

CLAY_API_KEY=your-key node dist/index.js

可用工具

人员工具

clay_search_people

搜索符合特定条件的人。

参数：

  • query （字符串，可选）：自然语言搜索查询
  • filters （对象，可选）：
    • titles：职位名称数组
    • companies：公司名称数组
    • industries：一系列行业
    • locations：一系列地点
    • companySize：公司规模范围（例如“51-200”）
    • seniorityLevels：资历级别数组
  • limit （数字，默认值25）：最大结果

例子：

{
  "query": "ML engineers",
  "filters": {
    "industries": ["Technology", "AI"],
    "companySize": "51-200"
  },
  "limit": 10
}

clay_enrich_person

获取特定人员的完整富集数据。

参数（至少需要一个）：

  • email：电子邮件地址
  • linkedinUrl：领英个人资料URL
  • fullName + company：名称和公司组合

例子：

{
  "email": "jane@example.com"
}

退货：

  • 全名、职务、公司
  • 工作经历历史
  • 教育
  • 技能
  • 社交资料（领英、推特、GitHub）
  • 位置详细信息
  • 联系方式

公司工具

clay_search_companies

搜索符合特定条件的公司。

参数：

  • query （字符串，可选）：自然语言搜索查询
  • filters （对象，可选）：
    • industries：一系列行业
    • technologies：一系列技术
    • employeeCount：尺寸范围（例如“51-200”）
    • fundingStage：筹资阶段（例如，“系列_ a”）
    • location：位置字符串
    • foundedAfter：年份（编号）
    • foundedBefore：年份（编号）
  • limit （数字，默认值25）：最大结果

例子：

{
  "filters": {
    "industries": ["AI", "Machine Learning"],
    "fundingStage": "series_a",
    "location": "San Francisco"
  }
}

clay_enrich_company

获取特定公司的完整富集数据。

参数（至少需要一个）：

  • domain：公司域名
  • name：公司名称
  • linkedinUrl：公司LinkedIn URL

例子：

{
  "domain": "anthropic.com"
}

退货：

  • 公司名称、域名、描述
  • 行业分类
  • 员工人数和范围
  • 创始年份
  • 位置详细信息
  • 融资信息（总融资额、上一轮融资、投资者）
  • 技术图形（使用的技术）
  • 社会概况
  • 最新消息

表格工具

clay_list_tables

列出工作区中的所有Clay桌子。

参数： 无

退货： 带有ID、名称、描述、行数和时间戳的表列表。

clay_get_table_schema

获取特定表的架构。

参数：

  • tableId （必填）：表ID

退货： 表元数据和列定义（名称、类型、描述）。

clay_query_table

使用过滤器查询Clay表。

参数：

  • tableId （必填）：表ID
  • filters （对象，可选）：过滤条件
  • sort （对象，可选）：排序配置
    • column：列名
    • order：“asc”或“desc”
  • limit （数字，默认值50）：最大结果
  • offset （数字，默认值0）：分页偏移

例子：

{
  "tableId": "tbl_abc123",
  "filters": { "status": "active" },
  "sort": { "column": "created_at", "order": "desc" },
  "limit": 25
}

资源

服务器将Clay表作为MCP资源公开：

  • clay://tables -列出所有表格
  • clay://tables/{id}/schema -表架构

发展

# Install dependencies
npm install

# Watch mode (rebuild on changes)
npm run dev

# Type check
npm run typecheck

# Build for production
npm run build

# Run the server
npm start

错误处理

服务器处理：

  • 速率限制 （429个响应），带有重试信息
  • API错误 带有描述性信息
  • 缺少认证 带有明确的错误信息
  • 无效参数 带有验证反馈

需求

API 参考

此服务器使用Clay.com REST API：

  • 基本URL: https://api.clay.com/v1
  • 身份验证：API密钥在 X-Api-Key 头球

有关Clay.com API文档，请访问：https://docs.clay.com/api

许可证

MIT许可证-请参阅 许可证 文件。

相关 MCP