JinDaGe - generect_mcp MCP Details

article

README

🚀 Generect Live API MCP 服务器

Generect Live API MCP 服务器是一个轻量级的 MCP 服务器，它为 B2B 潜在客户生成和公司搜索提供 Generect Live API 工具。

🚀 快速开始

获取 API 密钥

在 https://beta.generect.com 上注册并获取你的 API 密钥。

远程 MCP 服务器（推荐）

通过 MCP 注册表使用我们托管的 MCP 服务器：

{
  "mcpServers": {
    "generect": {
      "command": "mcp-remote",
      "args": [
        "https://mcp.generect.com/mcp",
        "--header",
        "Authorization: Bearer Token YOUR_API_KEY"
      ]
    }
  }
}

将 YOUR_API_KEY 替换为你从 beta.generect.com 获取的密钥。

本地安装（可选）

要求：Node >= 18
配置环境（通常通过你的 MCP 客户端设置）：

GENERECT_API_BASE=https://api.generect.com
GENERECT_API_KEY=Token <api-key>
GENERECT_TIMEOUT_MS=60000

本地开发（可选）

npm install
npm run dev

构建并启动（标准输入输出服务器）

npm run build && npm start

💻 使用示例

工具列表

search_leads：通过 ICP 过滤器搜索潜在客户（支持 timeout_ms）
search_companies：通过 ICP 过滤器搜索公司（支持 timeout_ms）
generate_email：根据姓名和域名生成电子邮件（支持 timeout_ms）
get_lead_by_url：通过领英个人资料 URL 获取潜在客户（支持 timeout_ms）
health：对 API 进行快速健康检查（可选 url，支持 timeout_ms）

Cursor 集成（settings.json 节选）

{
  "mcpServers": {
    "generect-liveapi": {
      "command": "node",
      "args": ["./node_modules/tsx/dist/cli.mjs", "src/server.ts"],
      "env": {
        "GENERECT_API_BASE": "https://api.generect.com",
        "GENERECT_API_KEY": "Token YOUR_API_KEY",
        "GENERECT_TIMEOUT_MS": "60000"
      }
    }
  }
}

Claude Desktop（MCP）设置

添加到 ~/.claude/claude_desktop_config.json（或通过 UI → MCP 服务器）。推荐通过 npx 运行，这样用户无需全局安装任何东西。

{
  "mcpServers": {
    "generect-api": {
      "command": "npx",
      "args": ["-y", "generect-ultimate-mcp@latest"],
      "env": {
        "GENERECT_API_BASE": "https://api.generect.com",
        "GENERECT_API_KEY": "Token YOUR_API_KEY",
        "GENERECT_TIMEOUT_MS": "60000",
        "MCP_DEBUG": "0"
      }
    }
  }
}

macOS 注意事项：如果 Claude 显示 "spawn npx ENOENT" 或通过 nvm 启动旧版本的 Node，请将 command 设置为 npx 的绝对路径并/或覆盖 PATH：

{
  "command": "/usr/local/bin/npx",
  "env": { "PATH": "/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin" }
}

不使用 npx 的替代方法：

npm i -g generect-ultimate-mcp

然后使用：

{ "command": "/usr/local/bin/generect-mcp", "args": [] }

Docker

本地构建：

docker build -t ghcr.io/generect/generect_mcp:local .

在容器中运行服务器：

docker run --rm \
  -e GENERECT_API_BASE=https://api.generect.com \
  -e GENERECT_API_KEY="Token YOUR_API_KEY" \
  ghcr.io/generect/generect_mcp:local

通过 SSH 远程连接（高级）

一些 MCP 客户端允许通过 SSH 生成服务器，在 SSH 会话中使用标准输入输出。示例配置：

{
  "mcpServers": {
    "generect-remote": {
      "command": "ssh",
      "args": [
        "user@remote-host",
        "-T",
        "node",
        "/opt/generect_mcp/dist/server.js"
      ],
      "env": {
        "GENERECT_API_BASE": "https://api.generect.com",
        "GENERECT_API_KEY": "Token YOUR_API_KEY",
        "GENERECT_TIMEOUT_MS": "60000"
      }
    }
  }
}

本地测试辅助工具

对 API 进行简单的健康检查：

npm run health -- <api-key>

通过本地 MCP 客户端调用工具：

npm run mcp:client -- <api-key>

generect_mcp