Clay MCP Server (Bpw Civic)

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错误 带有描述性信息
• 缺少认证 带有明确的错误信息
• 无效参数 带有验证反馈

需求

• Node.js 18+
• Clay.com 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许可证-请参阅 许可证 文件。