Metadata-Version: 2.4
Name: biaochengcheng-mcp
Version: 1.0.7
Summary: 全国工程招投标标讯查询 MCP Server — 标橙橙出品
License: MIT
Project-URL: Homepage, https://biaochengcheng.com
Project-URL: Repository, https://github.com/dayuer0606/bid_query_mcp
Keywords: mcp,bid,tender,招投标,标讯,biaochengcheng
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: requests>=2.31.0

# biaochengcheng-mcp · 标橙橙标讯查询 MCP

[![PyPI](https://img.shields.io/pypi/v/biaochengcheng-mcp)](https://pypi.org/project/biaochengcheng-mcp/)
[![ModelScope](https://img.shields.io/badge/ModelScope-MCP广场-blue)](https://modelscope.cn/mcp)
[![Python](https://img.shields.io/badge/Python-3.10%2B-green)](https://python.org)

查询全国工程**招投标标讯**的 MCP Server，数据由 [标橙橙](https://biaochengcheng.com) 提供，实时更新。

支持接入 Claude、Cursor、Cherry Studio 等任意 MCP 客户端；可在 ModelScope MCP 广场一键托管部署。

---

## 前置条件

当前免费使用，最高额度20000条数据
后续可在 [biaochengcheng.com](https://biaochengcheng.com) 注册账号并开通数据订阅，获取 `API Key`。

---

## 方式一：ModelScope 托管（推荐）

进入 [ModelScope MCP 广场](https://modelscope.cn/mcp) 搜索 **biaochengcheng-mcp**，点击「部署」，填写：

```
BIAOCHENGCHENG_API_KEY = 你的 API Key
```

平台自动生成专属 SSE 地址，直接填入 AI 客户端即可。

---

## 方式二：uvx 本地运行（Claude Desktop / Cursor）

无需 clone 代码，直接配置：

```json
{
  "mcpServers": {
    "biaochengcheng-mcp": {
      "command": "uvx",
      "args": ["biaochengcheng-mcp@latest"],
      "env": {
        "BIAOCHENGCHENG_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

> Claude Desktop 配置文件路径：`~/Library/Application Support/Claude/claude_desktop_config.json`

---

## 方式三：pip 安装后本地运行

```bash
pip install biaochengcheng-mcp
export BIAOCHENGCHENG_API_KEY=你的key
biaochengcheng-mcp
```

---

## 可用工具

### `mcp_bid_query` — 标讯列表查询

| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| `keyWord` | `list[str]` | ✅ | 搜索关键词数组，支持多关键词，例如 `["通讯工程", "光纤设备"]` |
| `searchScope` | `list[str]` | | 搜索范围，字符串数组，取值：1=标题，2=内容，4=招标人；可组合，默认 `["1", "2"]` |
| `searchMode` | `str` | | 搜索模式，1=精确匹配，2=分词匹配，默认 `1` |
| `projectAmount` | `float` | | 项目金额（单值匹配），**不推荐使用**，建议使用 `minAmount` + `maxAmount` 组合 |
| `startTime` | `str` | | 开始时间，格式 `yyyy-mm-dd hh:mm:ss`，默认近3个月 |
| `endTime` | `str` | | 结束时间，格式 `yyyy-mm-dd hh:mm:ss`，默认当前时间 |
| `maxAmount` | `float` | | 项目最大金额（单位：元），例如 `1000000` |
| `minAmount` | `float` | | 项目最小金额（单位：元），例如 `50000` |
| `selectAddr` | `list[str]` | | 省份全称数组，例如 `["湖南省", "内蒙古自治区"]` |
| `city` | `list[str]` | | 城市全称数组，例如 `["长沙市", "呼和浩特市"]` |
| `pageSize` | `int` | | 每页返回条数，范围 1-50，默认 `10` |
| `pageNum` | `int` | | 页码，从1开始，默认 `1` |

**示例 Prompt：**
```
查询关键词"通讯工程"的招标公告，返回前10条
```

---

## 环境变量

| 变量 | 必填 | 默认 | 说明 |
|------|:----:|------|------|
| `BIAOCHENGCHENG_API_KEY` | ✅ | — | 标橙橙 API Key |
| `MCP_TRANSPORT` | | `stdio` | `stdio` 本地 / `sse` 自托管HTTP |
| `PORT` | | `8000` | SSE 模式端口 |
