获取本 MCP 服务器的使用指南，包括工具列表、使用建议和重要提示。建议首次使用时调用此工具了解如何正确使用其他工具。

该工具无需必填参数，直接调用即可

通过关键词搜索中国国家统计局指标和数据（推荐优先使用）。返回匹配的数据集列表，包含 setId、名称、时间范围等信息。 Args: - keyword (string): 搜索关键词，如 "GDP"、"CPI"、"人口" - pageNum (number): 页码，默认1 - pageSize (number): 每页数量，默认10 - sortBy (string): 排序方式，可选 relevance（相关性）或 time（时间） - sortOrder (string): 排序顺序，可选 desc（降序）或 asc（升序） - categories (string[]): 数据类型过滤，如 ["月度数据", "季度数据"] - periodRange (object): 时间范围过滤 Returns: 匹配的数据集列表，包含 setId、名称、时间范围等信息

必填参数：keyword

获取中国国家统计局分类树节点。category=1月度/2季度/3年度/5分省季度/6分省年度/7其他。isEnd=true 的节点 id 即为 setId。 Args: - category (string): 分类代码：1月度 2季度 3年度 5分省季度 6分省年度 7其他 - parentId (string): 父节点ID，空或省略表示从根节点开始 Returns: 分类树节点列表

必填参数：category

根据数据集ID (setId) 获取所有可用指标列表，包含指标名称、ID、单位等。 Args: - setId (string): 数据集ID，来自 cnbs_search 或 cnbs_fetch_nodes 的 isEnd=true 节点 - name (string): 指标名称过滤（可选） Returns: 指标列表

必填参数：setId

批量获取统计指标数据。支持多个指标ID、多个时间段、多地区。 Args: - setId (string): 数据集ID - metricIds (string[]): 指标ID数组 - periods (string[]): 时间范围数组，如 ["202501MM-202503MM"] 或 ["2023YY-2025YY"] - areas (array): 地区维度，默认全国 - rootId (string): 根节点ID，月度数据默认为 fc982599aa684be7969d7b90b1bd0e84 Returns: 统计数据点列表

必填参数：setId、metricIds、periods

递归获取指定分类代码下所有叶子节点（setId）。注意：耗时长，不建议频繁使用。 Args: - category (string): 分类代码：1月度 2季度 3年度 5分省季度 6分省年度 7其他 Returns: 所有叶子节点列表

必填参数：category

获取缓存使用情况的统计信息。

该工具无需必填参数，直接调用即可

格式化统计数据值，支持设置精度。

必填参数：value

在不同单位之间转换统计数据值。

必填参数：value、sourceUnit、targetUnit

计算数据的基本统计信息，包括最小值、最大值、平均值和总和。

必填参数：values

获取可用的地区列表，用于分省数据查询。返回地区代码和名称列表。 Args: - keyword (string): 搜索关键词，可选，用于过滤地区 - level (string): 地区级别过滤，可选：province（省级）、city（市级）、county（县级） Returns: 地区列表，包含 code（地区代码）、name（全称）、shortName（简称） 示例： - 不传参数：返回所有省份 - keyword="广东"：返回广东省 - keyword="江"：返回名称包含"江"的省份（江苏、浙江等）

该工具无需必填参数，直接调用即可

获取所有数据分类信息，包括分类代码、名称和时间粒度。 Returns: 分类列表，包含代码、名称、时间粒度类型 示例返回： - 代码 1：月度数据（CPI、PPI等） - 代码 2：季度数据（GDP季度值等） - 代码 3：年度数据（GDP年度值、人口等） - 代码 6：分省年度数据

该工具无需必填参数，直接调用即可

批量搜索多个关键词的统计数据。一次性查询多个指标，提高效率。 Args: - keywords (string[]): 搜索关键词数组，如 ["GDP", "CPI", "人口"] - pageSize (number): 每个关键词返回的结果数量，默认5 Returns: 按关键词分组的搜索结果 示例： cnbs_batch_search(keywords=["GDP", "CPI", "出生率"]) 返回三个关键词各自的搜索结果

必填参数：keywords

对比不同地区或不同时间的数据。支持地区对比和时间对比。 Args: - keyword (string): 搜索关键词 - regions (string[]): 要对比的地区名称数组，如 ["北京", "上海", "广东"] - compareType (string): 对比类型，"region"（地区对比）或 "time"（时间对比） - years (string[]): 时间对比时的年份数组，如 ["2022", "2023", "2024"] Returns: 对比结果表格 示例： - 地区对比：cnbs_compare(keyword="GDP", regions=["北京", "上海"], compareType="region") - 时间对比：cnbs_compare(keyword="GDP", compareType="time", years=["2022", "2023", "2024"])

必填参数：keyword

同步国家统计局数据，确保数据的准确性和时效性。 Args: - categories (string[]): 要同步的分类代码数组，如 ["1", "2", "3"] - forceSync (boolean): 是否强制同步，忽略最近同步时间 Returns: 同步结果，包括每个分类的同步状态 示例： cnbs_sync_data(categories=["1", "2"], forceSync=true)

该工具无需必填参数，直接调用即可

获取数据同步状态，了解各分类数据的同步情况。 Args: - category (string): 分类代码，可选，不指定则返回所有分类的状态 Returns: 同步状态信息，包括最后同步时间、状态等 示例： cnbs_get_sync_status(category="3") // 获取年度数据的同步状态 cnbs_get_sync_status() // 获取所有分类的同步状态

该工具无需必填参数，直接调用即可

检查数据集的新鲜度，判断数据是否需要更新。 Args: - setId (string): 数据集ID Returns: 数据新鲜度信息，包括是否新鲜、最后更新时间等 示例： cnbs_check_data_freshness(setId="some_set_id")

必填参数：setId

列出所有可用的数据源，包括国家统计局数据、普查数据、国际数据等。 Returns: 数据源列表，包括名称、描述、状态等信息 示例： cnbs_list_data_sources()

该工具无需必填参数，直接调用即可

从特定数据源获取数据，支持扩展数据源。 Args: - source (string): 数据源名称，如 "cnbs"、"census"、"international"、"department" - params (object): 数据源特定的参数 Returns: 数据源返回的数据 ⚠️ FRED 注意：通过此工具调用 source="fred" 时，仅支持 FRED_API_KEY 环境变量，不支持 X-Fred-Api-Key 请求头。HTTP 模式请改用专用工具 ext_fred。 示例： cnbs_fetch_data_from_source(source="cnbs", params={keyword: "GDP"}) cnbs_fetch_data_from_source(source="census", params={type: "population", year: "2020"}) cnbs_fetch_data_from_source(source="international", params={source: "world_bank", indicator: "GDP", country: "CHN"}) cnbs_fetch_data_from_source(source="department", params={department: "finance", indicator: "财政收入", period: "2024Q1"})

必填参数：source、params

获取特定数据源的分类信息。 Args: - source (string): 数据源名称，如 "census"、"international"、"department" Returns: 数据源的分类信息 示例： cnbs_get_source_categories(source="census") cnbs_get_source_categories(source="international")

必填参数：source

在特定数据源中搜索数据。 Args: - source (string): 数据源名称，如 "census"、"international"、"department" - keyword (string): 搜索关键词 Returns: 搜索结果 示例： cnbs_search_in_source(source="census", keyword="人口") cnbs_search_in_source(source="international", keyword="GDP")

必填参数：source、keyword

评估数据质量，包括完整性、准确性、一致性和及时性。 Args: - data (array): 要评估的数据数组，每个元素应包含 value 字段 Returns: 数据质量评估结果，包括各项指标和问题列表 示例： cnbs_assess_data_quality(data=[{value: "100"}, {value: "200"}, {value: "无数据"}])

必填参数：data

生成数据摘要，包括总项数、有效项数、缺失项数、数据类型分布和时间范围。 Args: - data (array): 要分析的数据数组 Returns: 数据摘要信息 示例： cnbs_generate_summary(data=[{value: "100", period: "202401MM"}, {value: "200", period: "202402MM"}])

必填参数：data

增强的数字格式化，支持多种格式选项。 Args: - value (string): 要格式化的值 - precision (number): 小数位数，默认2 - format (string): 格式类型，可选 fixed（固定小数）、compact（紧凑格式）、percent（百分比） Returns: 格式化后的数字 示例： cnbs_enhanced_format_number(value="123456789", precision=2, format="compact") cnbs_enhanced_format_number(value="0.05", precision=1, format="percent")

必填参数：value

验证和清理数据，处理无数据标记、空白字符等。 Args: - value (string): 要验证和清理的值 Returns: 清理后的值，无数据返回 null 示例： cnbs_validate_data(value=" 1,234.56 ") cnbs_validate_data(value="无数据")

必填参数：value

生成数据可视化图表配置，支持多种图表类型。 Args: - type (string): 图表类型，可选 line、bar、pie、scatter、radar、heatmap、treemap、gauge - data (object): 图表数据 - options (object): 图表配置选项 Returns: 图表配置对象，可用于前端图表库 示例： cnbs_generate_chart(type="line", data={series: [{name: "GDP", data: [100, 110, 120, 130, 140]}], xAxis: {data: ["2020", "2021", "2022", "2023", "2024"]}}, options={title: "GDP趋势"})

必填参数：type、data

分析数据趋势，包括方向、变化量、变化百分比和斜率。 Args: - values (array): 数据值数组，按时间顺序排列 Returns: 趋势分析结果 示例： cnbs_analyze_trend(values=[100, 110, 120, 130, 140])

必填参数：values

分析两组数据之间的相关性。 Args: - data1 (array): 第一组数据值数组 - data2 (array): 第二组数据值数组 Returns: 相关性分析结果，包括相关系数和强度 示例： cnbs_analyze_correlation(data1=[100, 110, 120, 130, 140], data2=[50, 55, 60, 65, 70])

必填参数：data1、data2

检测数据中的异常值。 Args: - values (array): 数据值数组 - threshold (number): 异常检测阈值，默认2（标准差倍数） Returns: 异常检测结果，包括异常值列表和统计信息 示例： cnbs_detect_anomalies(values=[100, 110, 120, 500, 140], threshold=2)

必填参数：values

计算数据的基本统计信息，包括均值、中位数、标准差等。 Args: - values (array): 数据值数组 Returns: 统计分析结果 示例： cnbs_analyze_statistics(values=[100, 110, 120, 130, 140])

必填参数：values

分析时间序列数据，包括趋势、季节性等。 Args: - values (array): 时间序列数据值数组 - period (number): 季节性周期，默认12 Returns: 时间序列分析结果 示例： cnbs_analyze_time_series(values=[100, 110, 120, 130, 140, 150, 160, 170, 180, 190, 200, 210, 220], period=12)

必填参数：values

基于历史数据预测未来值。 Args: - values (array): 历史数据值数组 - futureSteps (number): 预测未来步数，默认5 Returns: 预测结果，包括历史数据和预测值 示例： cnbs_predict_data(values=[100, 110, 120, 130, 140], futureSteps=3)

必填参数：values

将数据标准化到[0, 1]范围。 Args: - values (array): 数据值数组 Returns: 标准化后的数据数组 示例： cnbs_normalize_data(values=[100, 110, 120, 130, 140])

必填参数：values

使用Z-score方法标准化数据。 Args: - values (array): 数据值数组 Returns: 标准化后的数据数组 示例： cnbs_standardize_data(values=[100, 110, 120, 130, 140])

必填参数：values

计算数据的移动平均值。 Args: - values (array): 数据值数组 - window (number): 移动窗口大小，默认3 Returns: 移动平均后的数据数组 示例： cnbs_moving_average(values=[100, 110, 120, 130, 140], window=3)

必填参数：values

对数据应用指数平滑。 Args: - values (array): 数据值数组 - alpha (number): 平滑系数，默认0.3 Returns: 平滑后的数据数组 示例： cnbs_exponential_smoothing(values=[100, 110, 120, 130, 140], alpha=0.3)

必填参数：values

查询世界银行开放数据。支持 GDP、CPI、贸易、人口、失业率等全球 200+ 国家数据。完全免费，无需认证。 Args: - indicator (string): 指标名（如 "GDP"、"CPI"、"UNEMPLOYMENT"）或 WB 指标代码（如 "NY.GDP.MKTP.CD"） - countries (string[]): ISO3 国家代码数组，如 ["CHN","USA","JPN"]；默认 ["CHN"] - startYear (number): 起始年份，默认 2000 - endYear (number): 结束年份，默认当前年 常用指标: GDP | GDP_GROWTH | GDP_PER_CAPITA | CPI | UNEMPLOYMENT | POPULATION | EXPORTS | IMPORTS | FDI_INFLOWS | GOVT_DEBT | GINI | LIFE_EXPECTANCY | CO2_EMISSIONS | CURRENT_ACCOUNT

必填参数：indicator

同时查询世界银行多个指标，跨国对比。 Args: - indicators (string[]): 指标数组，如 ["GDP_GROWTH","CPI","UNEMPLOYMENT"] - countries (string[]): ISO3 代码数组，如 ["CHN","USA","DEU"] - startYear (number): 起始年份 - endYear (number): 结束年份

必填参数：indicators

列出世界银行数据源支持的所有预置指标及其代码和说明。

该工具无需必填参数，直接调用即可

查询 IMF 世界经济展望 (WEO) 数据。支持 GDP 增速、通胀、失业率、经常账户、政府债务等。完全免费，无需认证。 Args: - indicator (string): 指标名如 "GDP_GROWTH"、"CPI_INFLATION" 或 IMF 代码如 "NGDP_RPCH" - countries (string[]): ISO 代码数组，如 ["CHN","USA","JPN"]；默认 ["CHN"] - periods (string[]): 年份数组，如 ["2020","2021","2022","2023"]；不传则返回全部 常用指标: GDP_GROWTH | GDP_USD | GDP_PER_CAPITA | CPI_INFLATION | UNEMPLOYMENT | CURRENT_ACCOUNT | GOVT_DEBT | GOVT_BALANCE | GROSS_SAVINGS | INVESTMENT | POPULATION

必填参数：indicator

列出 IMF DataMapper 支持的所有预置指标。

该工具无需必填参数，直接调用即可

获取 IMF DataMapper 完整指标目录（直接调用 IMF API）。

该工具无需必填参数，直接调用即可

查询 OECD 统计数据（SDMX-JSON）。支持季度GDP、就业、先行指标等。完全免费，无需认证。 Args: - dataset (string): 预置数据集名，如 "QNA_GDP"、"KEI_CPI"、"EMPLOYMENT" - key (string): SDMX 维度键，如 "Q.G20.B1GQ....V.N"（可选，默认 "all"，注意数据量可能较大） - startPeriod (string): 起始期间，如 "2015-Q1" 或 "2015-01" - lastNObservations (number): 返回最近 N 期，默认 20 预置数据集: QNA_GDP | KEI_CPI | EMPLOYMENT | TRADE

必填参数：dataset

列出 OECD 数据源支持的所有预置数据集。

该工具无需必填参数，直接调用即可

查询国际清算银行 (BIS) 统计数据。涵盖有效汇率、信贷缺口、住宅房价、债务偿还比率等金融稳定指标。完全免费，无需认证。 Args: - dataset (string): 数据集名，如 "EER"（有效汇率）、"CREDIT_GAP"（信贷缺口）、"PROPERTY_PRICES"（房价） - country (string): ISO2 代码，如 "CN"（中国）、"US"（美国）；默认 "CN" - lastNObservations (number): 最近 N 期，默认 20 - startPeriod (string): 起始期间，如 "2015-Q1" 或 "2015-01" 预置数据集: EER | CREDIT_GAP | TOTAL_CREDIT | PROPERTY_PRICES | DEBT_SERVICE | CROSS_BORDER_BANKING

必填参数：dataset

列出 BIS 数据源支持的所有预置数据集及键模板。

该工具无需必填参数，直接调用即可

查询美联储经济数据库 (FRED)。涵盖美国GDP、利率、汇率、通胀、大宗商品价格等 800,000+ 系列。 ⚠️ 需要 FRED API Key：在 MCP 客户端配置中添加请求头 X-Fred-Api-Key: <your_key>（在 https://fred.stlouisfed.org/docs/api/api_key.html 免费申请）。stdio 模式可改用 FRED_API_KEY 环境变量。 Args: - series (string): 系列名如 "US_GDP"、"FED_FUNDS"、"CNY_USD" 或 FRED 代码如 "GDP" - limit (number): 返回数量，默认 100 - sortOrder (string): "desc"（最新优先）或 "asc" - observationStart (string): 起始日期，如 "2010-01-01" 常用系列: US_GDP | US_GDP_GROWTH | FED_FUNDS | US_10Y_YIELD | US_2Y_YIELD | CNY_USD | EUR_USD | US_UNEMPLOYMENT | US_CPI | OIL_PRICE_WTI | GOLD_PRICE | US_M2 | SP500 | VIX | DOLLAR_INDEX

必填参数：series

列出 FRED 数据源支持的所有预置系列（利率、汇率、大宗商品、宏观经济等）。

该工具无需必填参数，直接调用即可

查询国家统计局普查数据（人口普查、经济普查、农业普查）。通过 NBS 官方 API 获取真实数据。 Args: - type (string): 普查类型 "population"（人口）| "economic"（经济）| "agriculture"（农业） - keyword (string): 自定义搜索关键词（可选，覆盖默认） - pageSize (number): 返回结果数，默认 20

该工具无需必填参数，直接调用即可

查询各部门在国家统计局发布的统计数据。涵盖财政、工业、商务、农业、货币金融、社会保障、房地产、能源等。 Args: - department (string): 部门键 - indicator (string): 具体指标关键词（可选，不填则用部门默认首个关键词） - pageSize (number): 返回数量，默认 20 - fetchAll (boolean): 是否获取该部门所有关键词数据（较慢），默认 false 可用部门: finance（财政）| industry（工业）| trade（商务）| agriculture（农业）| monetary（货币金融）| social_security（社保）| housing（房地产）| energy（能源）

必填参数：department

列出所有可查询的部门及其指标关键词列表。

该工具无需必填参数，直接调用即可

同时从世界银行和 IMF 获取同一指标的多国数据，快速进行国际横向对比。 Args: - wbIndicator (string): 世界银行指标，如 "GDP_GROWTH" - imfIndicator (string): IMF 指标，如 "GDP_GROWTH" - countries (string[]): ISO 代码，如 ["CHN","USA","DEU","JPN","IND"] - startYear (number): 起始年份

必填参数：wbIndicator