# 展会大数据服务

[该MCP服务提供全面的展会信息查询功能，包括企业参展记录、展会场馆信息、展会搜索等，帮助用户了解企业的展会参与情况和行业展会信息。](https://www.handaas.com/)

## 主要功能

- 🔍 企业关键词模糊搜索
- 🏢 企业参展记录查询
- 🏛️ 展会场馆信息查询
- 📅 展会搜索


## 环境要求

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

## 本地快速启动

### 1. 克隆项目
```bash
git clone https://github.com/handaas/exhibition-mcp-server
cd exhibition-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": {
    "handaas-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}
```

## STDIO版安装部署

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

```json
{
  "mcpServers": {
    "exhibition-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": {
    "exhibition-mcp-server":{
      "type": "streamableHttp",
      "url": "https://mcp.handaas.com/exhibition/exhibition_bigdata?token={token}"  
      }
  }
}
```

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


## 可用工具

### 1. exhibition_bigdata_fuzzy_search
**功能**: 企业关键词模糊查询

根据提供的企业名称、人名、品牌、产品、岗位等关键词模糊查询相关企业列表。

**参数**:
- `matchKeyword` (必需): 匹配关键词
- `pageIndex` (可选): 分页开始位置
- `pageSize` (可选): 分页结束位置

**返回值**:
- `total`: 总数

### 2. exhibition_bigdata_exhibition_participation
**功能**: 企业参展记录查询

查询企业在展会中的参展信息，返回该企业参加展会的详细信息，包括展会的时间、描述、名称及展馆等。

**参数**:
- `matchKeyword` (必需): 企业名称/注册号/统一社会信用代码/企业id
- `pageIndex` (可选): 页码
- `pageSize` (可选): 分页大小 - 一页最多获取50条数据
- `keywordType` (可选): 主体类型枚举

**返回值**:
- `total`: 总数
- `resultList`: 参展记录列表
  - `fairEndTime`: 闭展时间
  - `fairLogo`: 展会logo
  - `fairDesc`: 展会描述
  - `fairPavilion`: 展馆名称
  - `fairName`: 展会名称
  - `isOpen`: 是否开展
  - `fairBeginTime`: 开展时间

### 3. exhibition_bigdata_exhibition_venue_search
**功能**: 展会场馆搜索

提供展会会馆的搜索服务，根据用户输入的省份和城市信息，返回符合条件的会馆列表及相关详细信息。

**参数**:
- `pavilionRegion` (必需): 会馆所在地区 - 格式："省份,城市"，如："福建省,厦门市"
- `matchKeyword` (可选): 匹配关键词
- `pageIndex` (可选): 页码 - 从1开始
- `pageSize` (可选): 分页大小 - 一页最多获取50条数据

**返回值**:
- `total`: 总数
- `resultList`: 场馆结果列表
  - `pavilionContact`: 联系方式（1：固定电话，2：邮箱，5：传真）
  - `pavilionDesc`: 会馆简介
  - `fairCount`: 展会数
  - `pavilionAddress`: 会展地址
  - `_id`: 会馆id
  - `pavilionHomepage`: 会馆官网链接
  - `pavilionLogo`: 会馆logo
  - `pavilionName`: 会馆名称
  - `pavilionScale`: 展览面积

### 4. exhibition_bigdata_exhibition_search
**功能**: 展会信息搜索

根据用户输入的查询关键词搜索展会信息，返回与关键词匹配的展会列表。

**参数**:
- `matchKeyword` (可选): 搜索关键词 - 搜索展会名称/展品范围包含关键词的展会
- `pageIndex` (可选): 页码
- `pageSize` (可选): 分页大小 - 一页最多获取50条数据

**返回值**:
- `resultList`: 展会列表结果
  - `_id`: 展会id
  - 其他展会详细信息

## 使用场景

1. **展会管理**: 展会组织者管理和查询企业参与的历史和即将举办的展会信息
2. **参展策略**: 企业跟踪参展活动和计划未来的参展策略
3. **数据分析**: 展会数据分析公司收集企业参展数据进行大数据分析
4. **商业情报**: 了解企业动态和市场趋势
5. **场地选择**: 会展组织者寻找合适的展会场所
6. **行程规划**: 商务人士计划展会行程时查询场地信息

## 使用注意事项

1. **企业全称要求**: 在调用需要企业全称的接口时，如果没有企业全称则先调取exhibition_bigdata_fuzzy_search接口获取企业全称
2. **分页限制**: 一页最多获取50条数据
3. **地区格式**: 场馆查询时地区格式为"省份,城市"
4. **联系方式类型**: 场馆联系方式类型编码（1：固定电话，2：邮箱，5：传真）
5. **时间信息**: 关注展会的开展和闭展时间信息

## 使用提问示例


### exhibition_bigdata_exhibition_participation (企业参展记录查询)
3. 华为参加过哪些重要的科技展会？展会时间都是什么时候？
4. 比亚迪的参展记录有多少？都在哪些展馆举办的？
5. 小米最近参加的展会有哪些？展会描述是什么？

### exhibition_bigdata_exhibition_venue_search (展会场馆搜索)
6. 上海有哪些大型会展中心？展览面积多大？
7. 北京的展会场馆都有哪些？联系方式是什么？
8. 深圳的会展场地情况如何？举办了多少场展会？

### exhibition_bigdata_exhibition_search (展会信息搜索)
9. 汽车行业相关的展会有哪些？
10. 科技类展会都有什么？展会详情如何？
11. 最近有哪些电子产品相关的展览？