关键词

企业数据商业信息销售线索公司信息人员信息

使用说明

项目简介

Explorium MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 客户端提供访问 Explorium API 强大数据资源的桥梁。该服务器将 Explorium API 提供的企业和人员数据查询能力封装成一系列易于LLM调用的工具，使得LLM应用能够便捷地获取并利用结构化的商业信息，从而提升LLM在商业分析、市场研究、销售线索挖掘等领域的应用能力。

主要功能点

  • 企业数据查询与匹配: 提供多种工具用于查询和匹配企业信息，包括通过企业名称或域名匹配企业ID，以及根据行业、规模、地理位置等多种条件筛选企业。
  • 联系人 (人员) 数据查询与匹配: 支持根据姓名、公司、职位等信息查找联系人，并允许根据职位级别、部门、地理位置等条件筛选联系人信息。
  • 数据丰富工具: 提供丰富的企业和联系人数据增强工具，包括企业工商信息、技术栈、财务数据、员工评价、社交媒体动态、网站变更等，以及联系人的联系方式、LinkedIn信息、个人资料等。
  • 事件数据: 支持查询企业和联系人的关键事件，如融资事件、人事变动、产品发布等，帮助LLM理解企业和人员的动态。
  • 灵活的数据过滤与Autocomplete: 提供强大的数据过滤能力，并提供 autocomplete 工具，帮助LLM客户端获取可用的过滤条件和值，确保查询的准确性和有效性。

安装步骤

  1. 克隆仓库

    git clone https://github.com/explorium-ai/mcp-explorium.git
cd mcp-explorium

  2. 安装依赖并激活虚拟环境

    pip install uv
uv sync --group dev

  3. 配置 Explorium API Key

    • 在项目根目录下创建 '.env' 文件。
    • 在 '.env' 文件中添加你的 Explorium API Key： 
      EXPLORIUM_API_KEY=YOUR_EXPLORIUM_API_KEY
      请将 'YOUR_EXPLORIUM_API_KEY' 替换为你实际的 API Key。

服务器配置

要将 Explorium MCP Server 集成到 MCP 客户端（例如 Claude Desktop 或 Cursor），你需要配置服务器的启动命令和参数。以下是针对不同客户端的配置示例，你需要根据你的实际环境进行调整。

Claude Desktop 配置 (claude_desktop_config.json):

{
  "mcpServers": {
    "Explorium": {
      "command": "<UV_INSTALL_PATH>",  //  请替换为 uv 的安装路径，可以使用 'which uv' 命令查找
      "args": [
        "run",
        "--directory",
        "<REPOSITORY_PATH>",  // 请替换为仓库的绝对路径
        "mcp",
        "run",
        "local_dev_server.py"
      ],
      "env": {
        "EXPLORIUM_API_KEY": "<YOUR_API_KEY>" //  请替换为你的 Explorium API Key，或者确保在环境中已配置
      }
    }
  }
}

Cursor 配置 (Cursor Settings > Cursor Settings > MCP):

uv run --directory repo_path mcp run local_dev_server.py

请将 'repo_path' 替换为仓库的绝对路径。

基本使用方法

  1. 启动服务器 在项目根目录下，运行以下命令启动本地开发服务器：

    mcp dev local_dev_server.py

    或者直接运行 'local_dev_server.py' 文件。

  2. 在 MCP 客户端中使用

    • 确保 MCP 客户端（如 Claude Desktop 或 Cursor）已正确配置 Explorium MCP Server。
    • 在客户端中，你可以通过自然语言指令调用 Explorium MCP Server 提供的工具，例如：
      • "查找位于加利福尼亚州的软件公司" (对应 'fetch_businesses' 工具，可能需要先用 'autocomplete' 获取 'region_country_code' 的可用值)
      • "获取Microsoft的公司简介" (可能先用 'match_businesses' 匹配企业ID，再用 'enrich_businesses_firmographics' 获取详细信息)
      • "查找在Google担任经理的联系人" (可能需要先用 'autocomplete' 获取 'job_level' 和 'company_name' 的可用值，再用 'fetch_prospects' 查询)

    具体的工具使用方法请参考代码中每个工具函数的详细注释 (docstring)。

注意:

  • 首次使用前请确保已安装必要的开发依赖并激活虚拟环境 ('uv sync --group dev')。
  • 运行服务器前请配置好 'EXPLORIUM_API_KEY' 环境变量。
  • 本地开发服务器 ('local_dev_server.py') 适用于本地开发和测试。

信息

分类

商业系统

访问项目