bidding-mcp-server

handaas/bidding-mcp-server

3.2

If you are the rightful owner of bidding-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The MCP server provides comprehensive bidding data services, enabling users to analyze bidding activities and discover market opportunities.

招投标大数据服务

该MCP服务提供全面的招投标信息查询功能，包括中标统计、招标统计、采购统计、招投标信息查询、拟建项目查询等，帮助用户进行招投标分析和市场机会发现。

主要功能

  • 🔍 企业关键词模糊搜索
  • 🏆 企业中标统计分析
  • 📋 企业招标统计分析
  • 💼 企业采购统计分析
  • 📄 招投标信息查询
  • 🏗️ 拟建项目查询
  • 🔎 招投标信息搜索

环境要求

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

本地快速启动

1. 克隆项目

git clone https://github.com/handaas/bidding-mcp-server
cd bidding-mcp-server

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

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

3. 环境配置

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

cp .env.example .env

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

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key

4. streamable-http启动服务

python server/mcp_server.py streamable-http

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

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

5. Cursor / Cherry Studio MCP配置

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

STDIO版安装部署

设置Cursor / Cherry Studio MCP配置

{
  "mcpServers": {
    "bidding-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配置

{
  "mcpServers": {
    "bidding-mcp-server":{
      "type": "streamableHttp",
      "url": "https://mcp.handaas.com/bidding/bidding_bigdata?token={token}"  
      }
  }
}

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

可用工具

1. bid_bigdata_fuzzy_search

功能: 企业关键词模糊查询

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

参数:

  • matchKeyword (必需): 匹配关键词 - 查询各类信息包含匹配关键词的企业
  • pageIndex (可选): 分页开始位置
  • pageSize (可选): 分页结束位置 - 一页最多获取50条数据

返回值:

  • total: 总数
  • 其他企业相关信息

2. bid_bigdata_bid_win_stats

功能: 企业中标统计分析

根据企业名称、统一社会信用代码等获取企业标讯信息中中标信息统计项，包括标的分布、金额分布、区域分布及中标趋势等。

参数:

  • matchKeyword (必需): 匹配关键词 - 企业名称/注册号/统一社会信用代码/企业id
  • keywordType (可选): 主体类型 - name：企业名称，nameId：企业id，regNumber：注册号，socialCreditCode：统一社会信用代码

返回值:

  • winbidAmountStatList: 中标金额分布
    • range: 金额范围
    • percent: 比例
    • count: 数量
  • winbidAreaStat: 区域分布
    • area: 区域
    • count: 数量
  • winbidStatList: 中标标的分布
    • subjectMatter: 标的物
    • count: 数量
    • percent: 比例
  • winbidTrend: 中标趋势
    • year: 年份
    • count: 数量

3. bid_bigdata_bidding_info

功能: 企业招投标信息查询

根据输入的企业标识符，查询并返回该企业参与的招投标信息，包括招投标公告类型、项目地区、公告详情及与之相关的企业信息。

参数:

  • matchKeyword (必需): 匹配关键词 - 企业名称/注册号/统一社会信用代码/企业id
  • pageSize (可选): 分页大小 - 一页最多获取50条数据
  • keywordType (可选): 主体类型 - name：企业名称，nameId：企业id，regNumber：注册号，socialCreditCode：统一社会信用代码
  • pageIndex (可选): 页码 - 从1开始

返回值:

  • total: 总数
  • biddingId: 招投标Id
  • infoType: 招投标公告类型
  • projectRegion: 项目地区
  • publishDate: 公告发布时间
  • subjectMatterList: 标的物
  • title: 公告标题
  • role: 招投标角色 - 招标，中标
  • projectAmount: 项目金额
  • winningBidderList: 中标企业
  • purchasingBidderList: 招标企业

4. bid_bigdata_tender_stats

功能: 企业招标统计分析

根据企业名称、统一社会信用代码等获取企业标讯信息中招标信息统计项，包括标的分布、金额分布、区域分布及招标趋势等。

参数:

  • matchKeyword (必需): 匹配关键词 - 企业名称/注册号/统一社会信用代码/企业id
  • keywordType (可选): 主体类型 - name：企业名称，nameId：企业id，regNumber：注册号，socialCreditCode：统一社会信用代码

返回值:

  • tenderAmountStatList: 招标金额分布
    • range: 金额范围
    • percent: 比例
    • count: 数量
  • tenderAreaStat: 区域分布
    • area: 区域
    • count: 数量
  • tenderStatList: 招标标的分布
    • subjectMatter: 标的物
    • count: 数量
    • percent: 比例
  • tenderTrend: 招标趋势
    • year: 年份
    • count: 数量

5. bid_bigdata_procurement_stats

功能: 企业采购统计分析

根据企业名称或ID，获取企业采购统计信息，包括采购产品分布、采购区域分布等。

参数:

  • keywordType (可选): 主体类型 - name：企业名称，nameId：企业id，regNumber：注册号，socialCreditCode：统一社会信用代码
  • matchKeyword (必需): 匹配关键词 - 企业名称/注册号/统一社会信用代码/企业id

返回值:

  • purchasingProductStatList: 采购产品分布
    • count: 采购数量
    • percent: 占比
    • product: 产品名称
  • purchasingAreaStatList: 采购区域分布
    • times: 客户数
    • area: 地区

6. bid_bigdata_bid_search

功能: 招投标信息搜索

查询和筛选招投标信息，通过提供多种过滤条件返回符合条件的招投标公告详细信息。

参数:

  • matchKeyword (可选): 搜索关键词 - 默认按最新发布时间返回全部
  • biddingType (可选): 信息类型 - 招标类型枚举
  • biddingRegion (可选): 项目地区 - 多选，支持省份，城市
  • biddingAnncPubStartTime (可选): 发布开始日期 - 格式："2024-08-01"
  • biddingAnncPubEndTime (可选): 发布结束日期 - 格式："2024-11-01"
  • searchMode (可选): 搜索模式 - 标题匹配，标的物匹配，全文匹配
  • biddingProjectMaxAmount (可选): 项目金额最大值 - 单位：万
  • biddingPurchasingType (可选): 招标单位类型 - 政府，学校，医院等
  • biddingProjectMinAmount (可选): 项目金额最小值 - 单位：万
  • pageIndex (可选): 分页索引
  • pageSize (可选): 分页大小 - 一页最多获取50条

返回值:

  • total: 总数
  • biddingAnncTitle: 公告标题
  • biddingContent: 正文
  • biddingId: 公告id
  • biddingInfoType: 公告类型
  • biddingProjectType: 项目类型
  • biddingPublishTime: 公告时间
  • biddingEndTime: 招标截止时间
  • biddingProjectID: 项目编号
  • biddingAgentInfoList: 招标代理机构信息列表
  • biddingPurchasingInfoList: 招标单位相关信息列表
  • biddingWinningInfoList: 中标单位相关信息列表
  • biddingRegion: 招投标所属地区
  • hasFile: 有无附件

7. bid_bigdata_planned_projects

功能: 拟建项目查询

查询企业拟建公告的信息，提供通过企业名称、注册号、社会信用代码或企业ID等多种方式检索拟建项目的相关详情。

参数:

  • matchKeyword (必需): 匹配关键词 - 企业名称/注册号/统一社会信用代码/企业id
  • pageIndex (可选): 页码 - 从1开始
  • pageSize (可选): 分页大小 - 一页最多获取50条数据
  • keywordType (可选): 主体类型 - name：企业名称，nameId：企业id，regNumber：注册号，socialCreditCode：统一社会信用代码

返回值:

  • total: 总数
  • ppId: 项目id
  • deviceList: 待采设备
  • ppRegion: 建设地点
  • ppTitle: 项目名称
  • ppContent: 项目内容
  • ppPublishTime: 发布时间
  • ppApprovalTime: 评审时间

使用场景

  1. 政府采购: 查询合适的招标项目，了解招投标动态
  2. 企业投标: 查找投标机会，分析竞争对手情况
  3. 市场分析: 分析招投标市场趋势，制定商业策略
  4. 风险评估: 评估企业招投标能力和履约能力
  5. 商业拓展: 发现潜在商业机会和合作伙伴
  6. 行业研究: 了解特定行业的招投标活跃度

使用注意事项

  1. 企业全称要求: 在调用需要企业全称的接口时，如果没有企业全称则先调取bid_bigdata_fuzzy_search接口获取企业全称
  2. 分页限制: 一页最多获取50条数据
  3. 时间格式: 日期参数格式为"YYYY-MM-DD"
  4. 金额单位: 项目金额单位为万元
  5. 地区筛选: 支持按省份、城市进行多选筛选

使用提问示例

bid_bigdata_fuzzy_search (企业关键词模糊搜索)

  1. 帮我查找包含"中建"关键词的企业信息
  2. 搜索与"中铁"相关的企业列表
  3. 查询名称中包含"华为"的公司

bid_bigdata_bid_win_stats (企业中标统计分析)

  1. 分析中国建筑股份有限公司的中标统计情况
  2. 查询华为技术有限公司的中标金额分布
  3. 中铁建设集团的中标趋势分析

bid_bigdata_bidding_info (企业招投标信息查询)

  1. 查询中国建筑参与的招投标项目信息
  2. 华为最近的招投标记录有哪些？
  3. 中铁建设的招投标公告详情

bid_bigdata_tender_stats (企业招标统计分析)

  1. 分析国家电网的招标统计情况
  2. 查询中石油的招标金额分布
  3. 中国移动的招标趋势分析

bid_bigdata_procurement_stats (企业采购统计分析)

  1. 分析华为的采购产品分布情况
  2. 查询阿里巴巴的采购区域分布
  3. 腾讯的采购统计数据

bid_bigdata_bid_search (招投标信息搜索)

  1. 搜索最近的5G基站建设招标项目
  2. 查找广东省的政府采购招标信息
  3. 搜索金额在1000万以上的工程招标项目

bid_bigdata_planned_projects (拟建项目查询)

  1. 查询中国建筑的拟建项目信息
  2. 华为有哪些拟建工程项目？
  3. 中铁建设的拟建项目详情