linker-balance-mcp

石化产品平衡表 MCP Server —— 查询产能/产量/负荷/供需/库存。

工具列表

| 工具 | 用途 | |------|------| | query_production | 产能、产量、负荷率等生产指标查询 | | query_supply_demand | 供需平衡、库存数据查询 | | list_balance_dimensions | 获取维度可选值（避免参数拼错） |

数据覆盖

• 56 个石化产品（丙烯、粒料、MTBE、环氧丙烷等）
• 150+ 工厂，200+ 装置
• 19 个地区（华东/华北/华南/东北/西北/西南/华中/山东等）
• 数据源：Linker 石化企业管理平台（产能负荷数据库 + 贸易库存数据库）

配置

{
  "linker-balance": {
    "command": "npx",
    "args": ["-y", "linker-balance-mcp@latest"],
    "env": {
      "BALANCE_API_KEY": "trading-prod-20260323",
      "BALANCE_API_BASE": "http://hub.linker.net/api/mcp"
    }
  }
}

| 环境变量 | 必填 | 说明 | |---------|------|------| | BALANCE_API_KEY | ✅ | 接口认证 Key（即 X-MCP-Key） | | BALANCE_API_BASE | 否 | 接口地址，默认 http://hub.linker.net/api/mcp |

使用示例

各产品年产能排名：

query_production(start="2024-01", end="2024-12", grain="year", group_by="product", metrics="capacity,output,load_rate", limit=20)

丙烯最近半年月度供需：

query_supply_demand(product="丙烯", recent="6m", grain="month", group_by="product", metrics="supply,demand,gap")

查工厂名称：

list_balance_dimensions(dimension="factory", keyword="浙江")

返回格式

TSV（Tab-Separated Values），token 效率比 JSON 高 40%：

# 产能产量 | product=丙烯 | region=华东 | grain=month | 共 228 条 | offset=0 limit=5
product	unit_name	factory_name	region	group_name	period	output	load_rate
丙烯	东华扬子江石化 PDH	东华能源（张家港）新材料有限公司	华东	东华能源张家港	2024-01	49104	88.00
丙烯	东华扬子江石化 PDH	东华能源（张家港）新材料有限公司	华东	东华能源张家港	2024-02	45936	88.00
丙烯	东华扬子江石化 PDH	东华能源（张家港）新材料有限公司	华东	东华能源张家港	2024-03	49104	88.00

已知限制

• query_supply_demand：仅丙烯有完整的 demand/gap 数据，其余产品 demand 暂为 null
• query_supply_demand：工厂级明细的 supply 暂不可用，建议用 group_by=product 聚合
• list_balance_dimensions：已自动过滤脏数据（测试产品、丙烯1 等）

开发

cd packages/linker-balance-mcp
npm install
npm run build