内容
# explee-mcp
MCP 服务器封装了 [Explee](https://explee.com) B2B 数据 API。 为 AI 代理提供搜索公司和人员、丰富电子邮件和电话号码、运行 AI 代理和管理重复数据删除列表的工具。
## 工具列表
| 工具 | 描述 |
|---|---|
| `search_companies` | 按行业、地理位置、规模、收入、技术栈、资金、流量搜索公司 |
| `search_companies_by_domains` | 按域名批量丰富公司资料 |
| `search_people` | 按职位和公司筛选搜索专业人士 |
| `search_people_by_domains` | 按域名查找公司中的联系人 |
| `nl_to_filters` | 将自然语言 ICP 描述转换为结构化筛选条件 |
| `enrich_email` | 通过姓名 + 域名查找验证的专业电子邮件 |
| `enrich_phone` | 通过 LinkedIn URL 查找工作电话号码 |
| `create_batch_email_enrichment` | 异步批量电子邮件丰富 - 返回 `task_id` |
| `get_batch_enrichment` | 查询批量丰富作业的结果 |
| `create_find_and_enrich` | 在一个异步作业中组合搜索 + 电子邮件丰富 |
| `get_find_and_enrich` | 查询查找和丰富作业的结果 |
| `list_tasks` | 列出账户上的所有异步作业 |
| `list_agents` | 浏览可用的预建 Explee AI 代理 |
| `start_agent_run_by_id` | 按 ID 运行预建的代理 |
| `start_custom_agent_run` | 使用自己的系统和模式运行自定义代理 |
| `get_agent_run_status` | 查询代理运行的状态和结果 |
| `web_search` | 在代理工作流中进行网络搜索 |
| `get_billing_balance` | 查询 Explee 信用余额 |
| `topup_credits` | 购买额外积分 |
| `list_people_dedup_lists` | 列出人员重复数据删除列表 |
| `create_people_dedup_list` | 创建 LinkedIn URL 的排除列表 |
| `get_people_dedup_list` | 检索人员重复数据删除列表的内容 |
| `delete_people_dedup_list` | 删除人员重复数据删除列表 |
| `list_company_dedup_lists` | 列出公司重复数据删除列表 |
| `create_company_dedup_list` | 创建公司域名的排除列表 |
| `get_company_dedup_list` | 检索公司重复数据删除列表的内容 |
| `delete_company_dedup_list` | 删除公司重复数据删除列表 |
## 前置条件
- 一个 [Explee API 密钥](https://explee.com/api-keys)
---
## 选项 A — 使用托管服务器（推荐）
无需本地设置。在注册服务器时，将您的 Explee API 密钥作为 Bearer 令牌传递。
### Claude Code
```bash
claude mcp add --transport http explee https://explee.drreamer.digital/mcp \
--header "Authorization: Bearer YOUR_EXPLEE_API_KEY"
```
或手动添加到项目根目录的 `.mcp.json` 中：
```json
{
"mcpServers": {
"explee": {
"type": "http",
"url": "https://explee.drreamer.digital/mcp",
"headers": {
"Authorization": "Bearer YOUR_EXPLEE_API_KEY"
}
}
}
}
```
### Codex CLI
Codex 从环境变量中读取令牌，而不是在命令中嵌入它：
```bash
export EXPLEE_API_KEY=your_api_key_here
codex mcp add explee --url https://explee.drreamer.digital/mcp \
--bearer-token-env-var EXPLEE_API_KEY
```
或手动添加到 `~/.codex/config.toml`（全局）或 `.codex/config.toml`（项目）：
```toml
[mcp_servers.explee]
url = "https://explee.drreamer.digital/mcp"
bearer_token_env_var = "EXPLEE_API_KEY"
```
---
## 选项 B — 本地运行
### 设置
```bash
git clone https://github.com/digitaldrreamer/explee-mcp
cd explee-mcp
npm install
cp .env.example .env
```
编辑 `.env`:
```env
EXPLEE_API_KEY=your_api_key_here
PORT=3000
```
构建并启动：
```bash
npm run build
npm start
```
开发时自动重载：
```bash
npm run dev
```
服务器监听 `http://localhost:3000/mcp`。
### Claude Code
```bash
claude mcp add --transport http explee http://localhost:3000/mcp
```
不需要 `--header` - 服务器从自己的 `.env` 中读取 `EXPLEE_API_KEY`。
或手动在 `.mcp.json` 中：
```json
{
"mcpServers": {
"explee": {
"type": "http",
"url": "http://localhost:3000/mcp"
}
}
}
```
### Codex CLI
```bash
codex mcp add explee --url http://localhost:3000/mcp
```
或手动在 `.codex/config.toml` 中：
```toml
[mcp_servers.explee]
url = "http://localhost:3000/mcp"
```
---
## 健康检查
```bash
curl http://localhost:3000/health
# {"ok":true,"server":"explee-mcp","version":"1.0.0"}
```
