rfhub-mcp 0.3.0

package/README.md

@@ -0,0 +1,11 @@
+# rfhub-mcp
+
+An [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server for RFHub.
+
+## Usage
+
+### Via npx (no install)
+
+```bash
+npx rfhub-mcp
+```

package/dist/server.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import ArfcnCalculator4G from "./tools/arfcn-calculator-4g.js";
+import ArfcnCalculator5G from "./tools/arfcn-calculator-5g.js";
+import ArfcnCalculatorNTN from "./tools/arfcn-calculator-ntn.js";
+const mcpServer = new McpServer({
+    name: "rfhub-mcp",
+    version: "0.1.0",
+    title: "RFHUB MCP Server",
+    description: "RFHUB MCP Server",
+    websiteUrl: "https://rfhub.cn/mcp-server",
+});
+new ArfcnCalculator4G(mcpServer).registerAllTools();
+new ArfcnCalculator5G(mcpServer).registerAllTools();
+new ArfcnCalculatorNTN(mcpServer).registerAllTools();
+async function main() {
+    const transport = new StdioServerTransport();
+    await mcpServer.connect(transport);
+    console.log("MCP server is running...");
+}
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});

package/dist/tools/arfcn-calculator-4g.js

@@ -0,0 +1,137 @@
+import * as z from "zod/v4";
+import { safeApiPost } from "../utils/request.js";
+import { mcpExResponse } from "../utils/response.js";
+export default class ArfcnCalculator4G {
+    mcpServer;
+    constructor(mcpServer) {
+        mcpServer = mcpServer;
+    }
+    registerAllTools = () => {
+        this.registerComputeTool();
+    };
+    registerComputeTool = () => {
+        const ModeEnum = z.enum(["n", "f"]);
+        const DirectionEnum = z.enum(["uplink", "downlink"]);
+        const DuplexModeEnum = z.enum(["TDD", "FDD"]);
+        const computeInputSchema = z.object({
+            Mode: ModeEnum.optional().describe("计算模式，例如 n 表示频点模式，f 表示频率模式"),
+            DataTransmissionDirection: DirectionEnum.describe("数据传输方向，可选上行（uplink）、下行（downlink）"),
+            NREF: z.number().int().optional().describe('频点参考（NREF），例如 504999。用于在频点模式（Mode=`"n"`）下确定中心频率。'),
+            FREF: z.number().optional().describe('频率参考（FREF），单位为 MHz，例如 3500.0。用于在频率模式（Mode=`"f"`）下直接指定中心频率。'),
+            Band: z.string().optional().describe('频段标识符，例如 "b3"、"b41" 等'),
+            Bandwidth: z.number().positive().optional().describe("信道带宽，单位为 MHz，例如 100 表示 100MHz"),
+        });
+        const computeOutputSchema = z.object({
+            Mode: ModeEnum.nullable().optional(),
+            Mode_Error: z.string().nullable().optional(),
+            DataTransmissionDirection: DirectionEnum.nullable().optional(),
+            DataTransmissionDirection_Error: z.string().nullable().optional(),
+            NREF: z.number().int().nullable().optional(),
+            NREF_Error: z.string().nullable().optional(),
+            FREF: z.number().nullable().optional(),
+            FREF_Error: z.string().nullable().optional(),
+            BandOptions: z.array(z.string()).nullable().optional(),
+            BandOptions_Error: z.string().nullable().optional(),
+            Band: z.string().nullable().optional(),
+            Band_Error: z.string().nullable().optional(),
+            FREF_Low: z.number().nullable().optional(),
+            FREF_High: z.number().nullable().optional(),
+            NREF_First: z.number().int().nullable().optional(),
+            NREF_Last: z.number().int().nullable().optional(),
+            DuplexMode: DuplexModeEnum.nullable().optional(),
+            SCS: z.string().nullable().optional(),
+            BandwidthOptions: z.array(z.string()).nullable().optional(),
+            BandwidthOptions_Error: z.string().nullable().optional(),
+            Bandwidth: z.number().nullable().optional(),
+            Bandwidth_Error: z.string().nullable().optional(),
+            NRB: z.number().int().nullable().optional(),
+            FREF_AvailableLow: z.number().nullable().optional(),
+            FREF_AvailableHigh: z.number().nullable().optional(),
+        });
+        const apiResultSchema = z.object({
+            Mode: z.string().nullable().optional(),
+            Mode_Error: z.string().nullable().optional(),
+            DataTransmissionDirection: z.string().nullable().optional(),
+            DataTransmissionDirection_Error: z.string().nullable().optional(),
+            NREF: z.string().nullable().optional(),
+            NREF_Error: z.string().nullable().optional(),
+            FREF: z.string().nullable().optional(),
+            FREF_Error: z.string().nullable().optional(),
+            BandOptions: z.array(z.string()).nullable().optional(),
+            BandOptions_Error: z.string().nullable().optional(),
+            Band: z.string().nullable().optional(),
+            Band_Error: z.string().nullable().optional(),
+            FREF_Low: z.string().nullable().optional(),
+            FREF_High: z.string().nullable().optional(),
+            NREF_First: z.string().nullable().optional(),
+            NREF_Last: z.string().nullable().optional(),
+            DuplexMode: DuplexModeEnum.nullable().optional(),
+            SCS: z.string().nullable().optional(),
+            BandwidthOptions: z.array(z.string()).nullable().optional(),
+            BandwidthOptions_Error: z.string().nullable().optional(),
+            Bandwidth: z.string().nullable().optional(),
+            Bandwidth_Error: z.string().nullable().optional(),
+            NRB: z.string().nullable().optional(),
+            FREF_AvailableLow: z.string().nullable().optional(),
+            FREF_AvailableHigh: z.string().nullable().optional(),
+        });
+        this.mcpServer.registerTool("arfcn_calculator_4g_compute", {
+            title: "4G/LTE频点频率转换与对应频带信息",
+            description: "支持4G LTE网络中频率与频点之间的相互转换，并附带特定频段的详细信息展示",
+            inputSchema: computeInputSchema,
+            outputSchema: computeOutputSchema,
+        }, async (input) => {
+            try {
+                const apiRequest = {
+                    Mode: input.Mode ?? (input.NREF && "n"),
+                    DataTransmissionDirection: input.DataTransmissionDirection,
+                    Band: input.Band?.replaceAll("b", "").replaceAll("B", "") ?? null,
+                    NERF: input.NREF?.toString() ?? null,
+                    FERF: input.FREF?.toString() ?? null,
+                    Bandwidth: input.Bandwidth?.toString() ?? null,
+                };
+                const result = await safeApiPost("/api/arfcn-calculator-4g/compute", apiRequest);
+                const apiResult = apiResultSchema.parse(result);
+                const structuredContent = {
+                    Mode: apiResult.Mode ?? null,
+                    Mode_Error: apiResult.Mode_Error ?? null,
+                    DataTransmissionDirection: apiResult.DataTransmissionDirection ?? null,
+                    DataTransmissionDirection_Error: apiResult.DataTransmissionDirection_Error ?? null,
+                    NREF: apiResult.NREF ?? null,
+                    NREF_Error: apiResult.NREF_Error ?? null,
+                    FREF: apiResult.FREF ?? null,
+                    FREF_Error: apiResult.FREF_Error ?? null,
+                    BandOptions: apiResult.BandOptions ?? null,
+                    BandOptions_Error: apiResult.BandOptions_Error ?? null,
+                    Band: apiResult.Band ?? null,
+                    Band_Error: apiResult.Band_Error ?? null,
+                    FREF_Low: apiResult.FREF_Low ?? null,
+                    FREF_High: apiResult.FREF_High ?? null,
+                    NREF_First: apiResult.NREF_First ?? null,
+                    NREF_Last: apiResult.NREF_Last ?? null,
+                    DuplexMode: apiResult.DuplexMode ?? null,
+                    SCS: apiResult.SCS ?? null,
+                    BandwidthOptions: apiResult.BandwidthOptions ?? null,
+                    BandwidthOptions_Error: apiResult.BandwidthOptions_Error ?? null,
+                    Bandwidth: apiResult.Bandwidth ?? null,
+                    Bandwidth_Error: apiResult.Bandwidth_Error ?? null,
+                    NRB: apiResult.NRB ?? null,
+                    FREF_AvailableLow: apiResult.FREF_AvailableLow ?? null,
+                    FREF_AvailableHigh: apiResult.FREF_AvailableHigh ?? null,
+                };
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(structuredContent, null, 2),
+                        },
+                    ],
+                    structuredContent,
+                };
+            }
+            catch {
+                return mcpExResponse;
+            }
+        });
+    };
+}

package/dist/tools/arfcn-calculator-5g.js

@@ -0,0 +1,207 @@
+import * as z from "zod/v4";
+import { safeApiPost } from "../utils/request.js";
+import { mcpExResponse } from "../utils/response.js";
+export default class ArfcnCalculator5G {
+    mcpServer;
+    constructor(mcpServer) {
+        mcpServer = mcpServer;
+    }
+    registerAllTools = () => {
+        this.registerComputeTool();
+    };
+    registerComputeTool = () => {
+        const ModeEnum = z.enum(["n", "f"]);
+        const DirectionEnum = z.enum(["uplink", "downlink"]);
+        const DuplexModeEnum = z.enum(["TDD", "FDD"]);
+        const computeInputSchema = z.object({
+            Mode: ModeEnum.nullable().optional().describe("计算模式，例如 n 表示频点模式，f 表示频率模式"),
+            DataTransmissionDirection: DirectionEnum.describe("数据传输方向，可选上行（uplink）、下行（downlink）"),
+            NREF: z.number().int().nullable().optional().describe('频点参考值（NREF），例如 `"504999"`。用于在频点模式（Mode=`"n"`）下确定中心频率。'),
+            FREF: z.number().nullable().optional().describe('频率参考值（FREF），例如 `"3500.0"`。用于在频率模式（Mode=`"f"`）下直接指定中心频率。'),
+            Band: z.string().nullable().optional().describe('频段标识符，例如 `"n78"`、`"n41"` 等。用于确定频段的上下行配置、信道栅格（raster）及边界频率。'),
+            FRaster: z.number().int().nullable().optional().describe("频率栅格（Frequency Raster），单位为 kHz，例如 5、15。用于频点与频率之间的转换计算。"),
+            SCS: z.number().int().nullable().optional().describe("子载波间隔（Subcarrier Spacing），单位为 kHz，例如 15、30。影响资源块结构和带宽计算。"),
+            Bandwidth: z
+                .number()
+                .nullable()
+                .optional()
+                .describe("信道带宽（Channel Bandwidth），单位为 MHz，例如 5、20、100。用于确定传输带宽配置（Transmission Bandwidth Configuration）。"),
+            SSBlockSCS: z.number().int().nullable().optional().describe("SSB（Synchronization Signal Block）的子载波间隔，单位为 kHz，例如 15、30。"),
+            SSBlockPattern: z
+                .string()
+                .nullable()
+                .optional()
+                .describe('SSB 波束扫描图案类型，例如 `"Case A"`、`"Case B"`、`"Case C"`（FR1）或 `"Case D"`、`"Case E"`（FR2），影响 SSB 时域位置和数量。'),
+            GSCN: z
+                .number()
+                .int()
+                .nullable()
+                .optional()
+                .describe("全局同步信道号（Global Synchronization Channel Number），用于粗粒度频率搜索，特别是在非服务小区初始接入时。例如 504990"),
+            SSREF: z.number().nullable().optional().describe("SSB 中心频率对应的参考频率（单位：Hz 或 MHz，依上下文而定），常用于从 GSCN 或 SSB 配置反推绝对频率。"),
+            N: z.number().int().nullable().optional().describe("用于 SSB 频域位置计算的参数 N，通常与 GSCN 或 raster 相关。例如 6312"),
+            M: z.number().int().nullable().optional().describe("SSB 频域偏移步长因子，取决于频段和 SSB 子载波间隔。例如 1、3、5"),
+        });
+        const computeOutputSchema = z.object({
+            Mode: ModeEnum.nullable().optional(),
+            Mode_Error: z.string().nullable().optional(),
+            DataTransmissionDirection: DirectionEnum.nullable().optional(),
+            DataTransmissionDirection_Error: z.string().nullable().optional(),
+            NREF: z.number().int().nullable().optional(),
+            NREF_Error: z.string().nullable().optional(),
+            FREF: z.number().nullable().optional(),
+            FREF_Error: z.string().nullable().optional(),
+            FGlobalRaster: z.number().nullable().optional(), // 全局频率栅格，kHz（数值）
+            FrequencyRangeDesignation: z.string().nullable().optional(), // 频率范围标识符
+            BandOptions: z.array(z.string()).nullable().optional(),
+            BandOptions_Error: z.string().nullable().optional(),
+            Band: z.string().nullable().optional(),
+            Band_Error: z.string().nullable().optional(),
+            FREF_Low: z.number().nullable().optional(),
+            FREF_High: z.number().nullable().optional(),
+            FRasterOptions_Error: z.string().nullable().optional(),
+            FRasterOptions: z.array(z.string()).nullable().optional(),
+            FRaster: z.number().nullable().optional(),
+            FRaster_Error: z.string().nullable().optional(),
+            NREF_StepSize: z.number().int().nullable().optional(),
+            NREF_First: z.number().int().nullable().optional(),
+            NREF_Last: z.number().int().nullable().optional(),
+            DuplexMode: DuplexModeEnum.nullable().optional(),
+            SCSOptions: z.array(z.string()).nullable().optional(),
+            SCSOptions_Error: z.string().nullable().optional(),
+            SCS: z.string().nullable().optional(),
+            SCS_Error: z.string().nullable().optional(),
+            BandwidthOptions: z.array(z.string()).nullable().optional(),
+            BandwidthOptions_Error: z.string().nullable().optional(),
+            Bandwidth: z.number().nullable().optional(), // 带宽单位可能是 MHz，但以数字形式
+            Bandwidth_Error: z.string().nullable().optional(),
+            NRB: z.number().int().nullable().optional(), // 资源块数量，整数
+            MinimumGuardband: z.number().nullable().optional(), // 最小保护带宽，kHz（数值）
+            FREF_AvailableLow: z.number().nullable().optional(),
+            FREF_AvailableHigh: z.number().nullable().optional(),
+            SSBlockSCSOptions: z.array(z.number()).nullable().optional(),
+            SSBlockSCSOptions_Error: z.string().nullable().optional(),
+            SSBlockSCS: z.number().nullable().optional(),
+            SSBlockSCS_Error: z.string().nullable().optional(),
+            SSBlockPatternOptions: z.array(z.string()).nullable().optional(),
+            SSBlockPatternOptions_Error: z.string().nullable().optional(),
+            SSBlockPattern: z.string().nullable().optional(),
+            SSBlockPattern_Error: z.string().nullable().optional(),
+            NRaster: z.number().nullable().optional(),
+            GSCN_First: z.number().int().nullable().optional(),
+            GSCN_Last: z.number().int().nullable().optional(),
+            GSCN_StepSize: z.number().int().nullable().optional(),
+            GSCN: z.number().int().nullable().optional(),
+            GSCN_Error: z.string().nullable().optional(),
+            SSREF: z.number().nullable().optional(),
+            SSREF_Error: z.string().nullable().optional(),
+            SSBlockNREF: z.number().int().nullable().optional(),
+            N: z.number().int().nullable().optional(),
+            N_Error: z.string().nullable().optional(),
+            MOptions: z.array(z.number()).nullable().optional(),
+            MOptions_Error: z.string().nullable().optional(),
+            M: z.number().int().nullable().optional(),
+            M_Error: z.string().nullable().optional(),
+        });
+        const apiResultSchema = z.object({
+            Mode: ModeEnum.nullable().optional(),
+            Mode_Error: z.string().nullable().optional(),
+            DataTransmissionDirection: DirectionEnum.nullable().optional(),
+            DataTransmissionDirection_Error: z.string().nullable().optional(),
+            NREF: z.string().nullable().optional(),
+            NREF_Error: z.string().nullable().optional(),
+            FREF: z.string().nullable().optional(),
+            FREF_Error: z.string().nullable().optional(),
+            FGlobalRaster: z.string().nullable().optional(), // 全局频率栅格，kHz
+            FrequencyRangeDesignation: z.string().nullable().optional(), // 频率范围标识符
+            BandOptions: z.array(z.string()).nullable().optional(),
+            BandOptions_Error: z.string().nullable().optional(),
+            Band: z.string().nullable().optional(),
+            Band_Error: z.string().nullable().optional(),
+            FREF_Low: z.string().nullable().optional(),
+            FREF_High: z.string().nullable().optional(),
+            FRasterOptions_Error: z.string().nullable().optional(),
+            FRasterOptions: z.array(z.string()).nullable().optional(),
+            FRaster: z.string().nullable().optional(),
+            FRaster_Error: z.string().nullable().optional(),
+            NREF_StepSize: z.string().nullable().optional(),
+            NREF_First: z.string().nullable().optional(),
+            NREF_Last: z.string().nullable().optional(),
+            DuplexMode: DuplexModeEnum.nullable().optional(),
+            SCSOptions: z.array(z.string()).nullable().optional(),
+            SCSOptions_Error: z.string().nullable().optional(),
+            SCS: z.string().nullable().optional(),
+            SCS_Error: z.string().nullable().optional(),
+            BandwidthOptions: z.array(z.string()).nullable().optional(),
+            BandwidthOptions_Error: z.string().nullable().optional(),
+            Bandwidth: z.string().nullable().optional(),
+            Bandwidth_Error: z.string().nullable().optional(),
+            NRB: z.string().nullable().optional(),
+            MinimumGuardband: z.string().nullable().optional(),
+            FREF_AvailableLow: z.string().nullable().optional(),
+            FREF_AvailableHigh: z.string().nullable().optional(),
+            SSBlockSCSOptions: z.array(z.string()).nullable().optional(),
+            SSBlockSCSOptions_Error: z.string().nullable().optional(),
+            SSBlockSCS: z.string().nullable().optional(),
+            SSBlockSCS_Error: z.string().nullable().optional(),
+            SSBlockPatternOptions: z.array(z.string()).nullable().optional(),
+            SSBlockPatternOptions_Error: z.string().nullable().optional(),
+            SSBlockPattern: z.string().nullable().optional(),
+            SSBlockPattern_Error: z.string().nullable().optional(),
+            NRaster: z.string().nullable().optional(),
+            GSCN_First: z.string().nullable().optional(),
+            GSCN_Last: z.string().nullable().optional(),
+            GSCN_StepSize: z.string().nullable().optional(),
+            GSCN: z.string().nullable().optional(),
+            GSCN_Error: z.string().nullable().optional(),
+            SSREF: z.string().nullable().optional(),
+            SSREF_Error: z.string().nullable().optional(),
+            SSBlockNREF: z.string().nullable().optional(),
+            N: z.string().nullable().optional(),
+            N_Error: z.string().nullable().optional(),
+            MOptions: z.array(z.string()).nullable().optional(),
+            MOptions_Error: z.string().nullable().optional(),
+            M: z.string().nullable().optional(),
+            M_Error: z.string().nullable().optional(),
+        });
+        this.mcpServer.registerTool("arfcn_calculator_5g_compute", {
+            title: "5G/NR频点频率转换与对应频带信息",
+            description: "支持5G NR网络中频率与频点之间的相互转换，并附带特定频段的详细信息展示",
+            inputSchema: computeInputSchema,
+            outputSchema: computeOutputSchema,
+        }, async (input) => {
+            try {
+                const apiRequest = {
+                    Mode: input.Mode ?? (input.NREF && "n"),
+                    DataTransmissionDirection: input.DataTransmissionDirection,
+                    Band: input.Band?.replaceAll("b", "").replaceAll("B", "") ?? null,
+                    NERF: input.NREF?.toString() ?? null,
+                    FERF: input.FREF?.toString() ?? null,
+                    Bandwidth: input.Bandwidth?.toString() ?? null,
+                    FRaster: input.FRaster?.toString() ?? null,
+                    SCS: input.SCS?.toString() ?? null,
+                    SSBlockSCS: input.SSBlockSCS?.toString() ?? null,
+                    GSCN: input.GSCN?.toString() ?? null,
+                    SSREF: input.SSREF?.toString() ?? null,
+                    SSBlockPattern: input.SSBlockPattern?.toString() ?? null,
+                    N: input.N?.toString() ?? null,
+                    M: input.M?.toString() ?? null,
+                };
+                const result = await safeApiPost("/api/arfcn-calculator-5g/compute", apiRequest);
+                const apiResult = apiResultSchema.parse(result);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(apiResult, null, 2),
+                        },
+                    ],
+                    structuredContent: apiResult,
+                };
+            }
+            catch {
+                return mcpExResponse;
+            }
+        });
+    };
+}

package/dist/tools/arfcn-calculator-ntn.js

@@ -0,0 +1,207 @@
+import * as z from "zod/v4";
+import { safeApiPost } from "../utils/request.js";
+import { mcpExResponse } from "../utils/response.js";
+export default class ArfcnCalculatorNTN {
+    mcpServer;
+    constructor(mcpServer) {
+        mcpServer = mcpServer;
+    }
+    registerAllTools = () => {
+        this.registerComputeTool();
+    };
+    registerComputeTool = () => {
+        const ModeEnum = z.enum(["n", "f"]);
+        const DirectionEnum = z.enum(["uplink", "downlink"]);
+        const DuplexModeEnum = z.enum(["TDD", "FDD"]);
+        const computeInputSchema = z.object({
+            Mode: ModeEnum.nullable().optional().describe("计算模式，例如 n 表示频点模式，f 表示频率模式"),
+            DataTransmissionDirection: DirectionEnum.describe("数据传输方向，可选上行（uplink）、下行（downlink）"),
+            NREF: z.number().int().nullable().optional().describe('频点参考值（NREF），例如 `"504999"`。用于在频点模式（Mode=`"n"`）下确定中心频率。'),
+            FREF: z.number().nullable().optional().describe('频率参考值（FREF），例如 `"3500.0"`。用于在频率模式（Mode=`"f"`）下直接指定中心频率。'),
+            Band: z.string().nullable().optional().describe('频段标识符，例如 `"n78"`、`"n41"` 等。用于确定频段的上下行配置、信道栅格（raster）及边界频率。'),
+            FRaster: z.number().int().nullable().optional().describe("频率栅格（Frequency Raster），单位为 kHz，例如 5、15。用于频点与频率之间的转换计算。"),
+            SCS: z.number().int().nullable().optional().describe("子载波间隔（Subcarrier Spacing），单位为 kHz，例如 15、30。影响资源块结构和带宽计算。"),
+            Bandwidth: z
+                .number()
+                .nullable()
+                .optional()
+                .describe("信道带宽（Channel Bandwidth），单位为 MHz，例如 5、20、100。用于确定传输带宽配置（Transmission Bandwidth Configuration）。"),
+            SSBlockSCS: z.number().int().nullable().optional().describe("SSB（Synchronization Signal Block）的子载波间隔，单位为 kHz，例如 15、30。"),
+            SSBlockPattern: z
+                .string()
+                .nullable()
+                .optional()
+                .describe('SSB 波束扫描图案类型，例如 `"Case A"`、`"Case B"`、`"Case C"`（FR1）或 `"Case D"`、`"Case E"`（FR2），影响 SSB 时域位置和数量。'),
+            GSCN: z
+                .number()
+                .int()
+                .nullable()
+                .optional()
+                .describe("全局同步信道号（Global Synchronization Channel Number），用于粗粒度频率搜索，特别是在非服务小区初始接入时。例如 504990"),
+            SSREF: z.number().nullable().optional().describe("SSB 中心频率对应的参考频率（单位：Hz 或 MHz，依上下文而定），常用于从 GSCN 或 SSB 配置反推绝对频率。"),
+            N: z.number().int().nullable().optional().describe("用于 SSB 频域位置计算的参数 N，通常与 GSCN 或 raster 相关。例如 6312"),
+            M: z.number().int().nullable().optional().describe("SSB 频域偏移步长因子，取决于频段和 SSB 子载波间隔。例如 1、3、5"),
+        });
+        const computeOutputSchema = z.object({
+            Mode: ModeEnum.nullable().optional(),
+            Mode_Error: z.string().nullable().optional(),
+            DataTransmissionDirection: DirectionEnum.nullable().optional(),
+            DataTransmissionDirection_Error: z.string().nullable().optional(),
+            NREF: z.number().int().nullable().optional(),
+            NREF_Error: z.string().nullable().optional(),
+            FREF: z.number().nullable().optional(),
+            FREF_Error: z.string().nullable().optional(),
+            FGlobalRaster: z.number().nullable().optional(), // 全局频率栅格，kHz（数值）
+            FrequencyRangeDesignation: z.string().nullable().optional(), // 频率范围标识符
+            BandOptions: z.array(z.string()).nullable().optional(),
+            BandOptions_Error: z.string().nullable().optional(),
+            Band: z.string().nullable().optional(),
+            Band_Error: z.string().nullable().optional(),
+            FREF_Low: z.number().nullable().optional(),
+            FREF_High: z.number().nullable().optional(),
+            FRasterOptions_Error: z.string().nullable().optional(),
+            FRasterOptions: z.array(z.string()).nullable().optional(),
+            FRaster: z.number().nullable().optional(),
+            FRaster_Error: z.string().nullable().optional(),
+            NREF_StepSize: z.number().int().nullable().optional(),
+            NREF_First: z.number().int().nullable().optional(),
+            NREF_Last: z.number().int().nullable().optional(),
+            DuplexMode: DuplexModeEnum.nullable().optional(),
+            SCSOptions: z.array(z.string()).nullable().optional(),
+            SCSOptions_Error: z.string().nullable().optional(),
+            SCS: z.string().nullable().optional(),
+            SCS_Error: z.string().nullable().optional(),
+            BandwidthOptions: z.array(z.string()).nullable().optional(),
+            BandwidthOptions_Error: z.string().nullable().optional(),
+            Bandwidth: z.number().nullable().optional(), // 带宽单位可能是 MHz，但以数字形式
+            Bandwidth_Error: z.string().nullable().optional(),
+            NRB: z.number().int().nullable().optional(), // 资源块数量，整数
+            MinimumGuardband: z.number().nullable().optional(), // 最小保护带宽，kHz（数值）
+            FREF_AvailableLow: z.number().nullable().optional(),
+            FREF_AvailableHigh: z.number().nullable().optional(),
+            SSBlockSCSOptions: z.array(z.number()).nullable().optional(),
+            SSBlockSCSOptions_Error: z.string().nullable().optional(),
+            SSBlockSCS: z.number().nullable().optional(),
+            SSBlockSCS_Error: z.string().nullable().optional(),
+            SSBlockPatternOptions: z.array(z.string()).nullable().optional(),
+            SSBlockPatternOptions_Error: z.string().nullable().optional(),
+            SSBlockPattern: z.string().nullable().optional(),
+            SSBlockPattern_Error: z.string().nullable().optional(),
+            NRaster: z.number().nullable().optional(),
+            GSCN_First: z.number().int().nullable().optional(),
+            GSCN_Last: z.number().int().nullable().optional(),
+            GSCN_StepSize: z.number().int().nullable().optional(),
+            GSCN: z.number().int().nullable().optional(),
+            GSCN_Error: z.string().nullable().optional(),
+            SSREF: z.number().nullable().optional(),
+            SSREF_Error: z.string().nullable().optional(),
+            SSBlockNREF: z.number().int().nullable().optional(),
+            N: z.number().int().nullable().optional(),
+            N_Error: z.string().nullable().optional(),
+            MOptions: z.array(z.number()).nullable().optional(),
+            MOptions_Error: z.string().nullable().optional(),
+            M: z.number().int().nullable().optional(),
+            M_Error: z.string().nullable().optional(),
+        });
+        const apiResultSchema = z.object({
+            Mode: ModeEnum.nullable().optional(),
+            Mode_Error: z.string().nullable().optional(),
+            DataTransmissionDirection: DirectionEnum.nullable().optional(),
+            DataTransmissionDirection_Error: z.string().nullable().optional(),
+            NREF: z.string().nullable().optional(),
+            NREF_Error: z.string().nullable().optional(),
+            FREF: z.string().nullable().optional(),
+            FREF_Error: z.string().nullable().optional(),
+            FGlobalRaster: z.string().nullable().optional(), // 全局频率栅格，kHz
+            FrequencyRangeDesignation: z.string().nullable().optional(), // 频率范围标识符
+            BandOptions: z.array(z.string()).nullable().optional(),
+            BandOptions_Error: z.string().nullable().optional(),
+            Band: z.string().nullable().optional(),
+            Band_Error: z.string().nullable().optional(),
+            FREF_Low: z.string().nullable().optional(),
+            FREF_High: z.string().nullable().optional(),
+            FRasterOptions_Error: z.string().nullable().optional(),
+            FRasterOptions: z.array(z.string()).nullable().optional(),
+            FRaster: z.string().nullable().optional(),
+            FRaster_Error: z.string().nullable().optional(),
+            NREF_StepSize: z.string().nullable().optional(),
+            NREF_First: z.string().nullable().optional(),
+            NREF_Last: z.string().nullable().optional(),
+            DuplexMode: DuplexModeEnum.nullable().optional(),
+            SCSOptions: z.array(z.string()).nullable().optional(),
+            SCSOptions_Error: z.string().nullable().optional(),
+            SCS: z.string().nullable().optional(),
+            SCS_Error: z.string().nullable().optional(),
+            BandwidthOptions: z.array(z.string()).nullable().optional(),
+            BandwidthOptions_Error: z.string().nullable().optional(),
+            Bandwidth: z.string().nullable().optional(),
+            Bandwidth_Error: z.string().nullable().optional(),
+            NRB: z.string().nullable().optional(),
+            MinimumGuardband: z.string().nullable().optional(),
+            FREF_AvailableLow: z.string().nullable().optional(),
+            FREF_AvailableHigh: z.string().nullable().optional(),
+            SSBlockSCSOptions: z.array(z.string()).nullable().optional(),
+            SSBlockSCSOptions_Error: z.string().nullable().optional(),
+            SSBlockSCS: z.string().nullable().optional(),
+            SSBlockSCS_Error: z.string().nullable().optional(),
+            SSBlockPatternOptions: z.array(z.string()).nullable().optional(),
+            SSBlockPatternOptions_Error: z.string().nullable().optional(),
+            SSBlockPattern: z.string().nullable().optional(),
+            SSBlockPattern_Error: z.string().nullable().optional(),
+            NRaster: z.string().nullable().optional(),
+            GSCN_First: z.string().nullable().optional(),
+            GSCN_Last: z.string().nullable().optional(),
+            GSCN_StepSize: z.string().nullable().optional(),
+            GSCN: z.string().nullable().optional(),
+            GSCN_Error: z.string().nullable().optional(),
+            SSREF: z.string().nullable().optional(),
+            SSREF_Error: z.string().nullable().optional(),
+            SSBlockNREF: z.string().nullable().optional(),
+            N: z.string().nullable().optional(),
+            N_Error: z.string().nullable().optional(),
+            MOptions: z.array(z.string()).nullable().optional(),
+            MOptions_Error: z.string().nullable().optional(),
+            M: z.string().nullable().optional(),
+            M_Error: z.string().nullable().optional(),
+        });
+        this.mcpServer.registerTool("arfcn_calculator_ntn_compute", {
+            title: "NTN频点频率转换与对应频带信息",
+            description: "支持NTN网络中频率与频点之间的相互转换，并附带特定频段的详细信息展示",
+            inputSchema: computeInputSchema,
+            outputSchema: computeOutputSchema,
+        }, async (input) => {
+            try {
+                const apiRequest = {
+                    Mode: input.Mode ?? (input.NREF && "n"),
+                    DataTransmissionDirection: input.DataTransmissionDirection,
+                    Band: input.Band?.replaceAll("b", "").replaceAll("B", "") ?? null,
+                    NERF: input.NREF?.toString() ?? null,
+                    FERF: input.FREF?.toString() ?? null,
+                    Bandwidth: input.Bandwidth?.toString() ?? null,
+                    FRaster: input.FRaster?.toString() ?? null,
+                    SCS: input.SCS?.toString() ?? null,
+                    SSBlockSCS: input.SSBlockSCS?.toString() ?? null,
+                    GSCN: input.GSCN?.toString() ?? null,
+                    SSREF: input.SSREF?.toString() ?? null,
+                    SSBlockPattern: input.SSBlockPattern?.toString() ?? null,
+                    N: input.N?.toString() ?? null,
+                    M: input.M?.toString() ?? null,
+                };
+                const result = await safeApiPost("/api/arfcn-calculator-ntn/compute", apiRequest);
+                const apiResult = apiResultSchema.parse(result);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(apiResult, null, 2),
+                        },
+                    ],
+                    structuredContent: apiResult,
+                };
+            }
+            catch {
+                return mcpExResponse;
+            }
+        });
+    };
+}

package/dist/utils/request.js

@@ -0,0 +1,21 @@
+const BASE_URL = "https://rfhub.cn";
+/**
+ * 安全的 POST JSON 请求函数（自动拼接 BASE_URL）
+ * @param {string} endpoint - 接口路径，如 '/api/arfcn-calculator-4g'
+ * @param {object} data - 请求体数据
+ * @returns {Promise<object | null>}
+ */
+export async function safeApiPost(endpoint, data) {
+    const url = BASE_URL + endpoint;
+    const response = await fetch(url, {
+        method: "POST",
+        body: JSON.stringify(data),
+        headers: {
+            "Content-Type": "application/json",
+        },
+    });
+    if (!response.ok)
+        throw new Error("Network response was not ok");
+    const text = await response.text();
+    return JSON.parse(text);
+}

package/dist/utils/response.js

@@ -0,0 +1,8 @@
+export const mcpExResponse = {
+    content: [
+        {
+            type: "text",
+            text: "计算异常",
+        },
+    ],
+};

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "rfhub-mcp",
+  "version": "0.3.0",
+  "description": "",
+  "main": "dist/server.js",
+  "type": "module",
+  "bin": {
+    "rfhub-mcp": "./dist/server.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rimraf dist && tsc",
+    "start": "tsx src/server.ts"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "packageManager": "pnpm@10.24.0",
+  "devDependencies": {
+    "@types/node": "^25.0.10",
+    "rimraf": "^6.1.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "zod": "^4.3.6"
+  }
+}