national-stats-mcp 1.0.0

package/License

@@ -0,0 +1,201 @@
+Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,102 @@
+# 国家统计局MCP/Agent数据获取工具
+
+## 项目概述
+本项目是一个基于MCP（Model Context Protocol）协议的国家统计局数据获取服务，为AI Agent提供直接访问国家统计局API的功能。项目支持获取各种统计数据，包含关键词搜索、分类浏览、时间维度查询等功能，遵循国家统计局官方API接口最佳实践。
+
+主要特点：
+- ✅ 关键词搜索：直接搜索获取指标代码及最新值（推荐用于快速查询）
+- ✅ 树形分类：可浏览和递归获取所有分类/指标体系
+- ✅ 时间范围：可查询各数据库对应可用时间维度
+- ✅ 标准API：遵循国家统计局接口文档的全部规范
+- ✅ 容错机制：内置重试逻辑、请求延迟、数据验证等功能
+
+## 环境要求
+- Node.js 18+
+- npm or yarn
+
+## 安装指南
+安装所需依赖，请运行以下命令：
+```bash
+npm install
+```
+
+## 服务启动
+启动MCP服务器：
+```bash
+# 构建项目
+npm run build
+
+# 启动服务器（STDIO模式 - 适用于Claude Desktop等）
+npm start
+
+# 或启动HTTP服务器（端口模式）
+node dist/index.js --port 8080
+```
+
+## 可用工具
+
+### search_statistics（推荐）
+通过关键词搜索国家统计局指标和数据。可以快速查找指标及其最新值。
+- 参数：`keyword`（必需）- 搜索关键词，如 "GDP"、"人均可支配收入" 等
+- 参数：`db`（可选）- 数据库筛选，空=全部，可选"年度数据"或"季度数据"
+- 参数：`page`（可选）- 页码，从0开始
+
+### get_statistics_categories
+获取统计指标分类树，返回国家统计局分类体系（第一层）。
+- 参数：`dbcode`（必需）- 数据库代码，`wdcode`（可选）- 维度代码
+
+### get_statistics_leaf_categories
+递归获取特定数据库的所有叶子指标节点（分类下全部可查询指标）。
+- 参数：`dbcode`（必需）- 数据库代码
+
+### get_statistics_time_options
+获取指定数据库可选的时间范围维度。
+- 参数：`dbcode`（必需）- 数据库代码
+
+### get_statistics_data
+获取国家统计局特定指标的数据。
+- 参数：`zb`（必需）- 指标代码，`dbcode`（必需）- 数据库代码，`sj`（可选）- 时间范围
+
+### batch_get_statistics
+批量获取多个统计指标的数据。
+- 参数：`queries`（必需）- 查询参数数组
+
+## 模块介绍
+- `src/index.ts`: MCP服务器主入口，实现MCP协议规范
+- `src/api-client.ts`: 国家统计局API交互模块，提供完整的数据获取功能，包括搜索、分类、数据查询等
+
+## 遵循国家统计局API标准
+项目严格实现api_introduce.md中的接口规范，包含：
+- 搜索接口 `/search.htm` 用于关键词查找和快速获取最新值
+- 分类接口 `/easyquery.htm` 用于遍历指标分类树
+- 数据接口 `/easyquery.htm` 用于查询历史时间序列
+- 通过 `k1` 时间戳防缓存参数
+- URL编码处理 `wds` 和 `dfwds` 参数
+- 数据验证与错误处理最佳实践
+
+## 数据编码对应
+- `dbcode.json`: 存储数据库代码及其相应的名称
+- `zb.json`: 包含用于查询不同类型国家数据的类别和子类别代码
+- `wbcode.json`: 维度代码定义
+
+## 为AI Agent的使用
+本项目专门设计为MCP服务器，可以直接集成到AI Agent系统中，提供国家统计局数据查询能力。Agent可根据使用场景选择最合适的工具：
+
+- **快速查询**：使用 `search_statistics` 直接通过关键词获取指标和最新值
+- **分类浏览**：使用 `get_statistics_categories` 或 `get_statistics_leaf_categories` 查看指标体系
+- **深度查询**：使用 `get_statistics_time_options` 和 `get_statistics_data` 获取历史序列数据
+
+## 开发
+进行开发时可使用：
+```bash
+npm run dev
+```
+
+## 贡献
+欢迎对本代码进行修改。请确保遵循项目的编码标准。
+
+## 开源协议
+[MIT License](./License)
+
+
+

package/dbcode.json

@@ -0,0 +1,42 @@
+[
+    {
+        "dbcode": "hgyd",
+        "name": "月度数据"
+    },
+    {
+        "dbcode": "hgjd",
+        "name": "季度数据"
+    },
+    {
+        "dbcode": "hgnd",
+        "name": "年度数据"
+    },
+    {
+        "dbcode": "fsyd",
+        "name": "分省月度数据"
+    },
+    {
+        "dbcode": "fsjd",
+        "name": "分省季度数据"
+    },
+    {
+        "dbcode": "fsnd",
+        "name": "分省年度数据"
+    },
+    {
+        "dbcode": "csyd",
+        "name": "城市月度数据"
+    },
+    {
+        "dbcode": "csnd",
+        "name": "城市年度数据"
+    },
+    {
+        "dbcode": "gatyd",
+        "name": "港澳台月度数据"
+    },
+    {
+        "dbcode": "gatnd",
+        "name": "港澳台年度数据"
+    }
+]

package/dist/api-client.d.ts

@@ -0,0 +1,121 @@
+export interface StatsApiResponse {
+    returncode: number;
+    returndata: {
+        hasdatacount: number;
+        datanodes: Array<{
+            code: string;
+            data: {
+                data: number | string;
+                dotcount: number;
+                hasdata: boolean;
+                strdata: string;
+            };
+            wds: Array<{
+                valuecode: string;
+                wdcode: string;
+            }>;
+        }>;
+        wdnodes: Array<{
+            wdcode: string;
+            wdname: string;
+            nodes: Array<{
+                code: string;
+                name: string;
+                unit: string;
+                dotcount?: number;
+            }>;
+        }>;
+    };
+}
+export interface StatsSearchResult {
+    pagecount: number;
+    pagecurrent: number;
+    result: Array<{
+        data: string;
+        db: string;
+        reg: string;
+        sj: string;
+        zb: string;
+        report: string;
+    }>;
+}
+export interface SearchResponse {
+    name: string;
+    value: string;
+    time: string;
+    db: string;
+    zbCode: string;
+    cnCode: string;
+    dbcode: string;
+    sjCode: string;
+}
+export type CategoryResponse = Array<{
+    id: string;
+    pid: string | number;
+    name: string;
+    isParent: boolean;
+    dbcode: string;
+    wdcode: string;
+}>;
+export interface TimeDimensionResponse {
+    returncode: number;
+    returndata: Array<{
+        wdcode: string;
+        wdname: string;
+        issj: boolean;
+        selcode: string;
+        nodes: Array<{
+            code: string;
+            name: string;
+        }>;
+    }>;
+}
+export declare class StatsApiClient {
+    private baseUrl;
+    private cnMap;
+    /**
+     * 搜索指标
+     */
+    search(keyword: string, db?: string, page?: number): Promise<StatsSearchResult>;
+    /**
+     * 解析搜索结果
+     */
+    parseSearchResult(result: StatsSearchResult): SearchResponse[];
+    /**
+     * 获取指标分类树
+     */
+    getCategories(dbcode: string, wdcode?: string): Promise<CategoryResponse>;
+    /**
+     * 递归获取指标分类树的所有叶子节点（包含子节点）
+     */
+    getLeafCategories(dbcode: string): Promise<CategoryResponse>;
+    /**
+     * 获取特定ID的分类节点
+     */
+    private getTreeSpecificNode;
+    /**
+     * 获取时间维度信息
+     */
+    getTimeDimensions(dbcode: string): Promise<TimeDimensionResponse>;
+    /**
+     * 获取统计数据
+     */
+    getData(zb: string, dbcode: string, sj?: string): Promise<StatsApiResponse>;
+    /**
+     * 批量获取数据
+     */
+    batchGet(queryParams: Array<{
+        zb: string;
+        dbcode: string;
+        sj: string;
+    }>): Promise<Array<{
+        query: {
+            zb: string;
+            dbcode: string;
+            sj: string;
+        };
+        result: StatsApiResponse | null;
+        error?: string;
+    }>>;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.js

@@ -0,0 +1,223 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatsApiClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+// 国家统计局API客户端
+class StatsApiClient {
+    baseUrl = 'https://data.stats.gov.cn';
+    cnMap = {
+        'B01': 'hgjd', // 季度
+        'C01': 'hgnd', // 年度
+    };
+    /**
+     * 搜索指标
+     */
+    async search(keyword, db = '', page = 0) {
+        const params = new URLSearchParams({
+            s: encodeURIComponent(keyword),
+            m: 'searchdata',
+            db: encodeURIComponent(db),
+            p: page.toString(),
+        });
+        const searchUrl = `${this.baseUrl}/search.htm?${params}`;
+        try {
+            const response = await axios_1.default.get(searchUrl);
+            return response.data;
+        }
+        catch (error) {
+            if (axios_1.default.isAxiosError(error)) {
+                throw new Error(`API search request failed: ${error.response?.data || error.message}`);
+            }
+            throw new Error(`Request failed: ${error}`);
+        }
+    }
+    /**
+     * 解析搜索结果
+     */
+    parseSearchResult(result) {
+        return result.result.map(item => {
+            // 解析 report 字段获取参数
+            const reportParams = Object.fromEntries(item.report.split('&').map(p => {
+                const [key, value] = p.split('=');
+                return [key, value];
+            }));
+            // 确定数据库类型
+            const cnCode = reportParams.cn || 'B01'; // 默认为季度数据
+            const dbcode = this.cnMap[cnCode] || 'hgjd';
+            return {
+                name: item.zb,
+                value: item.data,
+                time: item.sj,
+                db: item.db,
+                zbCode: reportParams.zb || '',
+                cnCode,
+                dbcode,
+                sjCode: reportParams.sj || ''
+            };
+        });
+    }
+    /**
+     * 获取指标分类树
+     */
+    async getCategories(dbcode, wdcode = 'zb') {
+        const params = {
+            m: 'getTree',
+            id: 'zb', // 从指标根节点开始
+            dbcode,
+            wdcode
+        };
+        try {
+            const response = await axios_1.default.post(`${this.baseUrl}/easyquery.htm`, new URLSearchParams(params));
+            return response.data;
+        }
+        catch (error) {
+            if (axios_1.default.isAxiosError(error)) {
+                throw new Error(`API category request failed: ${error.response?.data || error.message}`);
+            }
+            throw new Error(`Request failed: ${error}`);
+        }
+    }
+    /**
+     * 递归获取指标分类树的所有叶子节点（包含子节点）
+     */
+    async getLeafCategories(dbcode) {
+        let allLeaves = [];
+        const getRecursively = async (nodeId) => {
+            let retries = 0;
+            const maxRetries = 3;
+            while (retries < maxRetries) {
+                try {
+                    // 添加延迟避免请求过于频繁
+                    await new Promise(resolve => setTimeout(resolve, 200));
+                    const categoryResp = await this.getTreeSpecificNode(nodeId, dbcode);
+                    for (const node of categoryResp) {
+                        if (!node.isParent) {
+                            allLeaves.push(node);
+                        }
+                        else {
+                            await getRecursively(node.id);
+                        }
+                    }
+                    return;
+                }
+                catch (error) {
+                    retries++;
+                    console.log(`Category request failed for node ${nodeId}, attempt ${retries}/${maxRetries}.`);
+                    if (retries >= maxRetries) {
+                        throw error;
+                    }
+                    // 延迟重试
+                    await new Promise(resolve => setTimeout(resolve, 1000 * retries));
+                }
+            }
+        };
+        await getRecursively('zb');
+        return allLeaves;
+    }
+    /**
+     * 获取特定ID的分类节点
+     */
+    async getTreeSpecificNode(id, dbcode, wdcode = 'zb') {
+        const params = {
+            m: 'getTree',
+            id,
+            dbcode,
+            wdcode
+        };
+        try {
+            const response = await axios_1.default.post(`${this.baseUrl}/easyquery.htm`, new URLSearchParams(params));
+            return response.data;
+        }
+        catch (error) {
+            if (axios_1.default.isAxiosError(error)) {
+                throw new Error(`API getTree request failed: ${error.response?.data || error.message}`);
+            }
+            throw new Error(`Request failed: ${error}`);
+        }
+    }
+    /**
+     * 获取时间维度信息
+     */
+    async getTimeDimensions(dbcode) {
+        const wds = '[]';
+        const params = {
+            m: 'getOtherWds',
+            dbcode,
+            rowcode: 'zb',
+            colcode: 'sj',
+            wds,
+            k1: Date.now(), // 添加时间戳防止缓存
+            h: 1
+        };
+        try {
+            const response = await axios_1.default.get(`${this.baseUrl}/easyquery.htm`, { params });
+            return response.data;
+        }
+        catch (error) {
+            if (axios_1.default.isAxiosError(error)) {
+                throw new Error(`API time dimension request failed: ${error.response?.data || error.message}`);
+            }
+            throw new Error(`Request failed: ${error}`);
+        }
+    }
+    /**
+     * 获取统计数据
+     */
+    async getData(zb, dbcode, sj = 'LAST30') {
+        const wds = JSON.stringify([{ "wdcode": "zb", "valuecode": zb }]);
+        const dfwds = JSON.stringify([{ "wdcode": "sj", "valuecode": sj }]);
+        const params = {
+            m: 'QueryData',
+            dbcode,
+            rowcode: 'zb',
+            colcode: 'sj',
+            // 编码数组形式的参数
+            wds: encodeURIComponent(wds),
+            dfwds: encodeURIComponent(dfwds),
+            k1: Date.now(), // 添加时间戳防止缓存
+            h: 1
+        };
+        const paramStr = Object.entries(params)
+            .map(([k, v]) => `${k}=${v}`)
+            .join('&');
+        try {
+            const response = await axios_1.default.get(`${this.baseUrl}/easyquery.htm?${paramStr}`);
+            return response.data;
+        }
+        catch (error) {
+            if (axios_1.default.isAxiosError(error)) {
+                throw new Error(`API query data request failed: ${error.response?.data || error.message}`);
+            }
+            throw new Error(`Request failed: ${error}`);
+        }
+    }
+    /**
+     * 批量获取数据
+     */
+    async batchGet(queryParams) {
+        const results = [];
+        for (const param of queryParams) {
+            try {
+                const result = await this.getData(param.zb, param.dbcode, param.sj);
+                results.push({
+                    query: param,
+                    result,
+                    error: undefined
+                });
+            }
+            catch (error) {
+                results.push({
+                    query: param,
+                    result: null,
+                    error: error.message
+                });
+            }
+        }
+        return results;
+    }
+}
+exports.StatsApiClient = StatsApiClient;
+//# sourceMappingURL=api-client.js.map

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const server: McpServer;
+export default server;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,266 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.server = void 0;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const mcp_http_server_1 = require("mcp-http-server");
+const api_client_1 = require("./api-client");
+const zod_1 = require("zod");
+const commander_1 = require("commander");
+// 获取版本号，这里使用package.json中的版本
+const VERSION = '1.0.0';
+// 创建API客户端实例
+const apiClient = new api_client_1.StatsApiClient();
+// 创建MCP服务器
+exports.server = new mcp_js_1.McpServer({
+    name: 'national-stats-mcp',
+    version: VERSION,
+    description: '国家统计局数据查询API'
+});
+// 设置服务器instructions
+exports.server.instructions = `
+    该服务主要用于帮助用户查询国家统计局的统计数据。
+
+    主要工具包括：
+    - search_statistics: 通过关键词搜索国家统计局数据（推荐用于快速查询）
+    - get_statistics_categories: 获取统计指标分类
+    - get_statistics_leaf_categories: 获取所有叶子指标（递归获取）
+    - get_statistics_time_options: 获取特定数据库可选的时间范围
+    - get_statistics_data: 获取特定统计指标的数据
+    - batch_get_statistics: 批量获取统计数据
+
+    使用说明：
+    - 对于快速查询，直接使用search_statistics根据关键词查找数据和指标code
+    - 如需浏览分类体系，调用get_statistics_categories获取分类树
+    - 要获取特定分类下的所有叶子指标，使用get_statistics_leaf_categories
+    - 查看可用时间范围调用get_statistics_time_options
+    - 根据指标代码查询具体数据使用get_statistics_data
+
+    配置选项：
+    - dbcode: 数据库代码，hgnd (年度数据)、hgjd (季度数据) 等
+    - zb: 指标代码，通过分类或搜索获取
+    - sj: 时间范围，如 LAST6 (最近6个季度)、2025 (指定年份) 等
+  `;
+// 注册搜索统计指标的工具（最推荐使用）
+exports.server.tool('search_statistics', '通过关键词搜索国家统计局指标和数据。可以快速查找指标及其最新值。', {
+    keyword: zod_1.z.string().describe('搜索关键词，如 "GDP"、"人均可支配收入" 等'),
+    db: zod_1.z.string().optional().default('').describe('数据库筛选，空=全部，可选 "年度数据" 或 "季度数据"'),
+    page: zod_1.z.number().optional().default(0).describe('页码，从0开始'),
+}, async (args) => {
+    const { keyword, db = '', page = 0 } = args;
+    try {
+        // 执行搜索
+        const searchResult = await apiClient.search(keyword, db, page);
+        // 解析搜索结果
+        const parsedResults = apiClient.parseSearchResult(searchResult);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        pagecount: searchResult.pagecount,
+                        pagecurrent: searchResult.pagecurrent,
+                        results: parsedResults
+                    }, null, 2)
+                }
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${error.message}`,
+                },
+            ],
+        };
+    }
+});
+// 注册获取统计分类的工具
+exports.server.tool('get_statistics_categories', '获取国家统计局的统计指标分类，返回分类树结构（第一层）', {
+    dbcode: zod_1.z.string()
+        .describe('数据库代码，指定数据类型：hgnd(年度数据), hgjd(季度数据)等'),
+    wdcode: zod_1.z.string()
+        .default('zb')
+        .describe('维度代码，默认为zb(指标)'),
+}, async (args) => {
+    const { dbcode, wdcode = 'zb' } = args;
+    try {
+        const data = await apiClient.getCategories(dbcode, wdcode);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(data, null, 2)
+                }
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${error.message}`,
+                },
+            ],
+        };
+    }
+});
+// 注册获取统计指标叶子节点的工具（递归获取所有叶子指标）
+exports.server.tool('get_statistics_leaf_categories', '递归获取国家统计局特定数据库的所有叶子指标节点（可查看分类下所有可查询指标）', {
+    dbcode: zod_1.z.string()
+        .describe('数据库代码，指定数据类型：hgnd(年度数据), hgjd(季度数据)等'),
+}, async (args) => {
+    const { dbcode } = args;
+    try {
+        const data = await apiClient.getLeafCategories(dbcode);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(data, null, 2)
+                }
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${error.message}`,
+                },
+            ],
+        };
+    }
+});
+// 注册获取统计时间维度选项的工具
+exports.server.tool('get_statistics_time_options', '获取指定数据库可选的时间范围维度', {
+    dbcode: zod_1.z.string()
+        .describe('数据库代码，指定数据类型：hgnd(年度数据), hgjd(季度数据)等'),
+}, async (args) => {
+    const { dbcode } = args;
+    try {
+        const data = await apiClient.getTimeDimensions(dbcode);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(data, null, 2)
+                }
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${error.message}`,
+                },
+            ],
+        };
+    }
+});
+// 注册获取统计数据的工具
+exports.server.tool('get_statistics_data', '获取国家统计局特定指标的数据', {
+    zb: zod_1.z.string().describe('指标代码，通过分类或搜索获取'),
+    dbcode: zod_1.z.string()
+        .describe('数据库代码，指定数据类型：hgnd(年度数据), hgjd(季度数据)等'),
+    sj: zod_1.z.string()
+        .default('LAST30')
+        .describe('时间范围，例如 LAST6 (最近6季度), 2025 (指定年份), LAST30 (最近30年) 等'),
+}, async (args) => {
+    const { zb, dbcode, sj = 'LAST30' } = args;
+    try {
+        const data = await apiClient.getData(zb, dbcode, sj);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(data, null, 2)
+                }
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${error.message}`,
+                },
+            ],
+        };
+    }
+});
+// 注册批量获取统计数据的工具
+exports.server.tool('batch_get_statistics', '批量获取国家统计局多个指标的数据', {
+    queries: zod_1.z.array(zod_1.z.object({
+        zb: zod_1.z.string().describe('指标代码'),
+        dbcode: zod_1.z.string().describe('数据库代码'),
+        sj: zod_1.z.string().optional().default('LAST30').describe('时间范围'),
+    })).describe('查询参数数组')
+}, async (args) => {
+    const { queries } = args;
+    try {
+        const results = await apiClient.batchGet(queries.map(q => ({
+            zb: q.zb,
+            dbcode: q.dbcode,
+            sj: q.sj || 'LAST30'
+        })));
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(results, null, 2)
+                }
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${error.message}`,
+                },
+            ],
+        };
+    }
+});
+// 启动服务器
+async function startServer() {
+    const program = new commander_1.Command();
+    program
+        .option('-p, --port <number>', 'Port to listen on for HTTP/SSE mode')
+        .option('-h, --host <host>', 'Host to listen on for HTTP/SSE mode', 'localhost')
+        .parse();
+    const options = program.opts();
+    // 通过端口参数判断是否使用HTTP模式还是STDIO模式
+    if (options.port) {
+        await (0, mcp_http_server_1.startSseAndStreamableHttpMcpServer)({
+            host: options.host,
+            port: parseInt(options.port),
+            createMcpServer: async ({ headers }) => {
+                return exports.server;
+            },
+        });
+    }
+    else {
+        // 使用STDIO模式
+        const transport = new stdio_js_1.StdioServerTransport();
+        await exports.server.connect(transport);
+    }
+}
+if (require.main === module) {
+    startServer().catch((error) => {
+        console.error('Failed to start server:', error);
+        process.exit(1);
+    });
+}
+exports.default = exports.server;
+//# sourceMappingURL=index.js.map

package/dist/types.d.ts

@@ -0,0 +1,25 @@
+export interface McpServer {
+    new (options: {
+        name: string;
+        version: string;
+        capabilities: {
+            resources?: Record<string, any>;
+            tools?: Record<string, any>;
+        };
+        instructions?: string;
+    }): McpServer;
+    tool(name: string, description: string, parameters: any, implementation: (args: any) => Promise<any>): void;
+    connect(transport: any): Promise<void>;
+}
+export interface SseAndStreamableHttpMcpServerOptions {
+    host: string;
+    port: number;
+    createMcpServer: (context: {
+        headers: Record<string, string>;
+    }) => Promise<any>;
+}
+export interface StdioServerTransport {
+    new (): StdioServerTransport;
+}
+export type StartHttpServerFn = (options: SseAndStreamableHttpMcpServerOptions) => Promise<void>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "national-stats-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for accessing National Bureau of Statistics data",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "lint": "eslint src --ext .ts",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "mcp",
+    "statistics",
+    "api"
+  ],
+  "author": "Notional Data",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.9.0",
+    "axios": "^1.8.4",
+    "commander": "^14.0.0",
+    "mcp-http-server": "^1.1.5",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^6.13.0",
+    "@typescript-eslint/parser": "^6.13.0",
+    "eslint": "^8.55.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0"
+  }
+}

package/wbcode.json

@@ -0,0 +1,14 @@
+[
+    {
+        "dbcode": "zb",
+        "name": "指标"
+    },
+    {
+        "dbcode": "reg",
+        "name": "地区"
+    },
+    {
+        "dbcode": "sj",
+        "name": "时间"
+    }
+]

package/zb.json

@@ -0,0 +1,226 @@
+[
+    {
+        "dbcode": "hgnd",
+        "id": "A01",
+        "isParent": true,
+        "name": "综合",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A02",
+        "isParent": true,
+        "name": "国民经济核算",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A03",
+        "isParent": true,
+        "name": "人口",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A04",
+        "isParent": true,
+        "name": "就业人员和工资",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A05",
+        "isParent": true,
+        "name": "固定资产投资和房地产",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A06",
+        "isParent": true,
+        "name": "对外经济贸易",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A07",
+        "isParent": true,
+        "name": "能源",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A08",
+        "isParent": true,
+        "name": "财政",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A09",
+        "isParent": true,
+        "name": "价格指数",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A0A",
+        "isParent": true,
+        "name": "人民生活",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A0B",
+        "isParent": true,
+        "name": "城市概况",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A0C",
+        "isParent": true,
+        "name": "资源和环境",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A0D",
+        "isParent": true,
+        "name": "农业",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A0E",
+        "isParent": true,
+        "name": "工业",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A0F",
+        "isParent": true,
+        "name": "建筑业",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A0G",
+        "isParent": true,
+        "name": "运输和邮电",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A0H",
+        "isParent": false,
+        "name": "社会消费品零售总额",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A0I",
+        "isParent": true,
+        "name": "批发和零售业",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A0J",
+        "isParent": true,
+        "name": "住宿和餐饮业",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A0K",
+        "isParent": true,
+        "name": "旅游业",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A0L",
+        "isParent": true,
+        "name": "金融业",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A0M",
+        "isParent": true,
+        "name": "教育",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A0N",
+        "isParent": true,
+        "name": "科技",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A0O",
+        "isParent": true,
+        "name": "卫生",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A0P",
+        "isParent": true,
+        "name": "社会服务",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A0Q",
+        "isParent": true,
+        "name": "文化",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A0R",
+        "isParent": true,
+        "name": "体育",
+        "pid": "",
+        "wdcode": "zb"
+    },
+    {
+        "dbcode": "hgnd",
+        "id": "A0S",
+        "isParent": true,
+        "name": "公共管理、社会保障及其他",
+        "pid": "",
+        "wdcode": "zb"
+    }
+]