# supply-mcp-server

**Repository Path**: handaas/supply-mcp-server

## Basic Information

- **Project Name**: supply-mcp-server
- **Description**: HandaaS supply-mcp-server — MCP 数据服务
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-14
- **Last Updated**: 2026-10-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: handaas, MCP, MCP-Server, 企业大数据, ModelContextProtocol

## README

# 供应链潜客推荐服务

[该MCP服务提供HANDAAS潜客推荐查询，实现根据产品关键词查询下游产品目录，然后结合下游产品关键词通过潜客搜索查询企业清单。](https://www.handaas.com/)


## 主要功能

- 🔍 下游产品目录查询
- 🏭 下游企业清单查询
- 📊 企业筛选与过滤
- 📈 分页查询支持

## 环境要求

- Python 3.10+
- 依赖包：python-dotenv, requests, mcp

## 本地快速启动

### 1. 克隆项目
```bash
git clone https://github.com/handaas/supply-mcp-server
cd supply-mcp-server
```

### 2. 创建虚拟环境&安装依赖

```bash
python -m venv mcp_env && source mcp_env/bin/activate
pip install -r requirements.txt
```

### 3. 环境配置

复制环境变量模板并配置：

```bash
cp .env.example .env
```

编辑 `.env` 文件，配置以下环境变量：

```env
INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key
```

### 4. streamable-http启动服务

```bash
python server/mcp_server.py streamable-http
```

服务将在 `http://localhost:8000` 启动。

#### 支持启动方式 stdio 或 sse 或 streamable-http

### 5. Cursor / Cherry Studio MCP配置

```json
{
  "mcpServers": {
    "supply-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}
```

## STDIO版安装部署

### 设置Cursor / Cherry Studio MCP配置

```json
{
  "mcpServers": {
    "supply-mcp-server": {
      "command": "uv",
      "args": ["run", "mcp", "run", "{workdir}/server/mcp_server.py"],
      "env": {
        "PATH": "{workdir}/mcp_env/bin:$PATH",
        "PYTHONPATH": "{workdir}/mcp_env",
        "INTEGRATOR_ID": "your_integrator_id",
        "SECRET_ID": "your_secret_id",
        "SECRET_KEY": "your_secret_key"
      }
    }
  }
}
```

## 使用官方Remote服务

### 1. 直接设置Cursor / Cherry Studio MCP配置

```json
{
  "mcpServers": {
    "supply-mcp-server":{
      "type": "streamableHttp",
      "url": "https://mcp.handaas.com/supply/supply_recommend?token={token}"
      }
  }
}
```

### 注意：integrator_id、secret_id、secret_key及token需要登录 https://www.handaas.com/ 进行注册开通平台获取


## 可用工具

### 1. supply_get_down_stream_products
**功能**: 查询下游产品目录

该接口通过输入供应链产品关键词查询下游产品目录。

**参数**:
- `keywords` (必需): 供应链产品关键词 - 多个词中间用英文逗号分隔

**返回值**:
- `total`: 查询总数 - 类型 int
- `resultList`: 结果列表 - 类型 list of dict
  - `industry`: 下游行业 - 类型 string
  - `products`: 下游产品 - 类型 list of string

### 2. supply_get_down_stream_enterprises
**功能**: 查询下游企业清单

该接口通过输入下游产品关键词查询企业清单。

**参数**:
- `keywords` (必需): 下游产品关键词 - 多个词中间用英文逗号分隔
- `mainProducts` (可选): 下游产品 - 多个词中间用英文逗号分隔
- `isForeignTrade` (可选): 是否外贸企业 - 是，否
- `factoryInspectionType` (可选): 是否验厂 - 是，否
- `foundTimeStart` (可选): 成立时间开始 - yyyy-mm-dd
- `foundTimeEnd` (可选): 成立时间截至 - yyyy-mm-dd
- `address` (可选): 地区 - 单选，可以选到市级，示例："福建省,厦门市"或"福建省"
- `isTopEnterprise` (可选): 是否500强企业 - 是，否
- `isHighTechEnterprise` (可选): 是否高新企业 - 是，否
- `isGazelleEnterprise` (可选): 是否瞪羚企业 - 是，否
- `isUnicornEnterprise` (可选): 是否独角兽企业 - 是，否
- `hasStock` (可选): 是否上市企业 - 是，否
- `hasDevice` (可选): 是否机械设备企业 - 是，否
- `hasPack` (可选): 是否包装包材企业 - 是，否
- `regCapitalMin` (可选): 注册资本最小值 - 单位：万人民币
- `regCapitalMax` (可选): 注册资本最大值 - 单位：万人民币
- `pageIndex` (可选): 页码 - 默认值为1
- `pageSize` (可选): 分页大小，默认50，最大100

**返回值**:
- `total`: 查询总数
- `resultList`: 结果列表
  - `enterpriseId`: 企业id
  - `name`: 企业名称
  - `city`: 城市
  - `province`: 省份
  - `addressValue`: 详细地址
  - `factoryInspectionType`: 验厂类型
  - `factoryRecommendReason`: 推荐理由
  - `foundTime`: 成立时间
  - `isFactoryEnterprise`: 是否工厂型企业
  - `mainProducts`: 主营产品
  - `regCapital`: 注册资本
  - `regCapitalRmb`: 注册资本（人民币）
  - `factoryRecommendReason`: 推荐理由
    - `headWord`: 主营产品
    - `reason`: 关联原因
    - `tailWord`: 上游产品
  - `regCapital`: 注册资本
    - `value`: 金额
    - `coinType`: 币种
    - `origin`: 原始值

## 使用场景

1. **供应链拓展**: 根据上游产品关键词，查找潜在的下游客户
2. **市场调研**: 分析特定产品在不同行业的下游应用情况
3. **企业筛选**: 通过多种条件筛选符合要求的企业客户
4. **商业拓展**: 发现新的商业机会和潜在合作伙伴
5. **行业分析**: 了解产品供应链的分布和企业情况

## 使用注意事项

1. **关键词格式**: 多个关键词之间用英文逗号分隔
2. **地区筛选**: 支持省级和市级筛选，格式为"省份,城市"或"省份"
3. **分页参数**: 默认分页大小为50，最大100；`pageIndex` 从 1 开始，不限制总页数。
4. **时间格式**: 日期参数格式为"yyyy-mm-dd"
5. **注册资本**: 金额单位为万元人民币

## 使用提问示例

### supply_get_down_stream_products (下游产品目录查询)
1. 帮我查找"钢材"相关的下游产品有哪些？
2. 查询"化工原料"可以应用到哪些下游行业？
3. 搜索与"电子元件"相关的下游产品目录

### supply_get_down_stream_enterprises (下游企业清单查询)
1. 查找使用"钢材"的下游企业有哪些？
2. 查询广东省使用"化工原料"的企业清单
3. 搜索高新技术企业中使用"电子元件"的公司
4. 查找注册资本在1000万以上的下游企业
5. 查询2020年后成立的使用"包装材料"的企业