proxy-api-mcp 1.0.0

package/dist/src/tools/api/preprocessors/kingdee.js

@@ -0,0 +1,149 @@
+import { CACHE } from "../../../utils/cache";
+import { env } from '../../../config/env';
+import { ApiExecutor } from '../executor';
+import * as crypto from "crypto";
+export class KingdeeAsyncFetchTokenPreprocessor {
+    name = 'kingdee_Preprocessor';
+    cache;
+    domain = env.get('KINGDEE_DOMAIN');
+    appId = env.get('KINGDEE_APP_ID');
+    username = env.get('KINGDEE_USERNAME');
+    algorithm = env.get('KINGDEE_ALGORITHM');
+    secret = env.get('KINGDEE_SECRET');
+    lcid = env.get('KINGDEE_LCID');
+    acctId = env.get('KINGDEE_ACCT_ID');
+    constructor() {
+        this.cache = new CACHE();
+    }
+    async preprocess(requestData) {
+        const token = await this.getToken();
+        if (requestData.body) {
+            // kingdee_request
+            const body = requestData.body;
+            // kingdee_url
+            let kingdeeUrl = null;
+            const totalPath = this.domain + body.kingdee_path;
+            const lowerPath = totalPath.toLowerCase();
+            if (lowerPath.endsWith('.common.kdsvc')) {
+                kingdeeUrl = lowerPath;
+            }
+            else {
+                kingdeeUrl = `${lowerPath}.common.kdsvc`;
+            }
+            if (body.kingdee_query) {
+                const queryParams = Object.keys(body.kingdee_query)
+                    .map(key => `${key}=${String(body.kingdee_query[key])}`)
+                    .join("&");
+                const linkCode = kingdeeUrl.includes("?") ? "&" : "?";
+                kingdeeUrl = kingdeeUrl + linkCode + queryParams;
+            }
+            // timestamp
+            const timestamp = Date.now().toString();
+            // api_signature
+            const apigwSec = this.appId.split("_")[1];
+            const urlPath = encodeURIComponent(totalPath);
+            const context = `POST
+${urlPath}
+
+x-api-nonce:${timestamp}
+x-api-timestamp:${timestamp}
+`;
+            const signature = crypto
+                .createHmac('HmacSHA256', apigwSec)
+                .update(context)
+                .digest("base64");
+            // kdJson
+            const data = `${this.appId},${this.username},${this.lcid},`;
+            const dataSignature = crypto
+                .createHmac('HmacSHA256', this.secret)
+                .update(this.appId + data)
+                .digest('base64');
+            const kdJson = {
+                kd_appData: Buffer.from(data, "utf8").toString("base64"),
+                kd_signature: dataSignature
+            };
+            let requestBody = {};
+            if (body.kingdee_method === 'GET') {
+                requestBody = {};
+            }
+            else {
+                requestBody = body;
+            }
+            let bodyToken = {};
+            if (typeof token === 'string') {
+                bodyToken = JSON.parse(token);
+            }
+            else {
+                bodyToken = token;
+            }
+            const cookie = `ASP.NET_SessionId=${String(bodyToken.SessionId)};kdservice-sessionid=${String(bodyToken.KDSVCSessionId)}`;
+            const apiExec = new ApiExecutor({
+                name: this.name,
+                description: '',
+                method: 'GET',
+                // TODO
+                path: this.domain,
+                headers: {
+                    'Content-Type': 'application/json;charset=UTF-8',
+                    'Cookie': cookie,
+                    'X-Api-ClientID': '2.0',
+                    'x-api-timestamp': timestamp,
+                    'x-api-nonce': timestamp,
+                    "x-api-signheaders": "X-Api-TimeStamp,X-Api-Nonce",
+                    "X-Api-Signature": signature,
+                    'X-Kd-Appkey': this.appId,
+                    "X-Kd-Appdata": kdJson.kd_appData,
+                    "X-Kd-Signature": kdJson.kd_signature
+                },
+                baseUrl: this.domain,
+            });
+            await apiExec.execute(requestBody).then((resp) => {
+                return resp;
+            });
+        }
+        return requestData;
+    }
+    async getToken() {
+        let resultToken = {};
+        // kingdee_cache_key
+        const cachekey = `${this.acctId}:${this.appId}:${this.username}`;
+        // kingdee_hazelcast
+        resultToken = this.cache.get(cachekey);
+        if (resultToken) {
+            // nothing
+        }
+        else {
+            const apiExec = new ApiExecutor({
+                name: this.name,
+                description: '',
+                method: 'POST',
+                // TODO
+                path: `${this.domain}/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.AuthService.LoginBySign.common.kdsvc`,
+                baseUrl: this.domain,
+            });
+            // 请求body
+            const ts = Math.floor(Date.now() / 1000).toString();
+            const arr = [this.acctId, this.username, this.appId, this.secret, ts].sort();
+            const sign = crypto.createHash(this.algorithm)
+                .update(arr.join(""), 'utf8')
+                .digest('hex'); // 输出十六进制，可改为 'base64'
+            const parameters = [
+                this.acctId, this.username, this.appId, ts, sign, this.lcid
+            ];
+            resultToken = await apiExec.execute({ parameters }).then((resp) => {
+                const result = resp;
+                if (result && result.LoginResultType === 1) {
+                    const cacheValue = { "SessionId": result.Context.SessionId, "KDSVCSessionId": result.KDSVCSessionId };
+                    this.cache.set(cachekey, cacheValue);
+                    return cacheValue;
+                }
+                else {
+                    // 报错
+                    throw new Error("请求内容为空");
+                }
+            });
+        }
+        return resultToken;
+    }
+}
+//# sourceMappingURL=kingdee.js.map

package/dist/src/tools/api/preprocessors/kingdee.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kingdee.js","sourceRoot":"","sources":["../../../../../src/tools/api/preprocessors/kingdee.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAUjC,MAAM,OAAO,kCAAkC;IAClC,IAAI,GAAG,sBAAsB,CAAC;IACvC,KAAK,CAAqB;IACjB,MAAM,GAAW,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC3C,KAAK,GAAW,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC1C,QAAQ,GAAW,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC/C,SAAS,GAAW,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACjD,MAAM,GAAW,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC3C,IAAI,GAAW,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACvC,MAAM,GAAW,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACrD;QACI,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,EAAE,CAAA;IAC5B,CAAC;IACD,KAAK,CAAC,UAAU,CACZ,WAAwB;QAExB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAA;QACnC,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;YACnB,kBAAkB;YAClB,MAAM,IAAI,GAAG,WAAW,CAAC,IAKxB,CAAA;YACD,cAAc;YACd,IAAI,UAAU,GAAG,IAAI,CAAA;YACrB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,CAAA;YACjD,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,EAAE,CAAA;YACzC,IAAI,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;gBACtC,UAAU,GAAG,SAAS,CAAA;YAC1B,CAAC;iBAAM,CAAC;gBACJ,UAAU,GAAG,GAAG,SAAS,eAAe,CAAA;YAC5C,CAAC;YACD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACrB,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC;qBAC9C,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;qBACvD,IAAI,CAAC,GAAG,CAAC,CAAC;gBAEf,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;gBACtD,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAA;YAEpD,CAAC;YACD,YAAY;YACZ,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAA;YACvC,gBAAgB;YAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;YAC9C,MAAM,OAAO,GACT;EACd,OAAO;;cAEK,SAAS;kBACL,SAAS;CAC1B,CAAA;YACW,MAAM,SAAS,GAAG,MAAM;iBACnB,UAAU,CAAC,YAAY,EAAE,QAAQ,CAAC;iBAClC,MAAM,CAAC,OAAO,CAAC;iBACf,MAAM,CAAC,QAAQ,CAAC,CAAC;YACtB,SAAS;YACT,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,GAAG,CAAA;YAC3D,MAAM,aAAa,GAAG,MAAM;iBACvB,UAAU,CAAC,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC;iBACrC,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;iBACzB,MAAM,CAAC,QAAQ,CAAC,CAAC;YACtB,MAAM,MAAM,GAAG;gBACX,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACxD,YAAY,EAAE,aAAa;aAC9B,CAAA;YAED,IAAI,WAAW,GAAG,EAAE,CAAA;YACpB,IAAI,IAAI,CAAC,cAAc,KAAK,KAAK,EAAE,CAAC;gBAChC,WAAW,GAAG,EAAE,CAAA;YACpB,CAAC;iBAAM,CAAC;gBACJ,WAAW,GAAG,IAAI,CAAA;YACtB,CAAC;YACD,IAAI,SAAS,GAA4B,EAAE,CAAA;YAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC5B,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YACjC,CAAC;iBAAM,CAAC;gBACJ,SAAS,GAAG,KAA2C,CAAA;YAC3D,CAAC;YACD,MAAM,MAAM,GAAG,qBAAqB,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,wBAAwB,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAA;YAEzH,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC;gBAC5B,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,EAAE;gBACf,MAAM,EAAE,KAAK;gBACb,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,MAAM;gBACjB,OAAO,EAAE;oBACL,cAAc,EAAE,gCAAgC;oBAChD,QAAQ,EAAE,MAAM;oBAChB,gBAAgB,EAAE,KAAK;oBACvB,iBAAiB,EAAE,SAAS;oBAC5B,aAAa,EAAE,SAAS;oBACxB,mBAAmB,EAAE,6BAA6B;oBAClD,iBAAiB,EAAE,SAAS;oBAC5B,aAAa,EAAE,IAAI,CAAC,KAAK;oBACzB,cAAc,EAAE,MAAM,CAAC,UAAU;oBACjC,gBAAgB,EAAE,MAAM,CAAC,YAAY;iBACxC;gBACD,OAAO,EAAE,IAAI,CAAC,MAAM;aAEvB,CAAC,CAAA;YACF,MAAM,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;gBAC7C,OAAO,IAAI,CAAA;YACf,CAAC,CAAC,CAAA;QACN,CAAC;QACD,OAAO,WAAW,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,QAAQ;QACV,IAAI,WAAW,GAAG,EAAyB,CAAA;QAC3C,oBAAoB;QACpB,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAA;QAChE,oBAAoB;QACpB,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACtC,IAAI,WAAW,EAAE,CAAC;YACd,UAAU;QACd,CAAC;aAAM,CAAC;YACJ,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC;gBAC5B,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,EAAE;gBACf,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,+EAA+E;gBACnG,OAAO,EAAE,IAAI,CAAC,MAAM;aACvB,CAAC,CAAA;YACF,SAAS;YACT,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAA;YACnD,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;YAC5E,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;iBACzC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;iBAC5B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,sBAAsB;YAE1C,MAAM,UAAU,GAAG;gBACf,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI;aAC9D,CAAA;YACD,WAAW,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;gBAC9D,MAAM,MAAM,GAAG,IAMd,CAAA;gBAED,IAAI,MAAM,IAAI,MAAM,CAAC,eAAe,KAAK,CAAC,EAAE,CAAC;oBACzC,MAAM,UAAU,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,gBAAgB,EAAE,MAAM,CAAC,cAAc,EAAE,CAAA;oBACrG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;oBACpC,OAAO,UAAU,CAAA;gBACrB,CAAC;qBAAM,CAAC;oBACJ,KAAK;oBACL,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC9B,CAAC;YACL,CAAC,CAAC,CAAA;QACN,CAAC;QACD,OAAO,WAAW,CAAA;IACtB,CAAC;CAEJ"}

package/dist/src/tools/api/types.d.ts

@@ -0,0 +1,174 @@
+/**
+ * API 工具类型定义
+ */
+/**
+ * HTTP 请求方法
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
+/**
+ * 参数位置
+ */
+export type ParameterLocation = 'query' | 'path' | 'header' | 'body';
+/**
+ * 参数定义
+ */
+export interface ApiParameter {
+    /** 参数名称 */
+    name: string;
+    /** 参数位置 */
+    in: ParameterLocation;
+    /** 参数描述 */
+    description?: string;
+    /** 是否必需 */
+    required?: boolean;
+    /** 参数类型 */
+    type: 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object';
+    /** 默认值 */
+    default?: unknown;
+    /** 枚举值 */
+    enum?: unknown[];
+    /** 数组项类型(当 type='array' 时) */
+    items?: {
+        type: string;
+        properties?: Record<string, unknown>;
+    };
+    /** 对象属性(当 type='object' 时) */
+    properties?: Record<string, ApiParameter>;
+}
+/**
+ * 请求体定义
+ */
+export interface ApiRequestBody {
+    /** 请求体描述 */
+    description?: string;
+    /** 是否必需 */
+    required?: boolean;
+    /** 内容类型 */
+    contentType?: string;
+    /** Schema 定义 */
+    schema: Record<string, unknown>;
+}
+/**
+ * 请求预处理上下文
+ */
+export interface RequestPreprocessContext {
+    /** 工具名称 */
+    toolName: string;
+    /** 原始参数 */
+    args: Record<string, unknown>;
+    /** API 工具配置 */
+    config: ApiToolConfig;
+}
+/**
+ * 请求数据 - 预处理器可以修改的所有请求数据
+ */
+export interface RequestData {
+    /** 请求 URL（可能包含路径参数占位符） */
+    url: string;
+    /** 查询参数 */
+    query: Record<string, unknown>;
+    /** 请求头 */
+    headers: Record<string, string>;
+    /** 请求体 */
+    body?: unknown;
+    /** 路径参数 */
+    pathParams: Record<string, unknown>;
+}
+/**
+ * 请求预处理器接口
+ */
+export interface RequestPreprocessor {
+    /**
+     * 预处理器名称（唯一标识）
+     */
+    readonly name: string;
+    /**
+     * 预处理请求数据
+     * @param requestData - 请求数据（可修改）
+     * @param context - 预处理上下文
+     * @returns 处理后的请求数据或 Promise
+     */
+    preprocess(requestData: RequestData, context: RequestPreprocessContext): RequestData | Promise<RequestData>;
+}
+/**
+ * 响应转换配置
+ */
+export interface ResponseTransform {
+    /** 提取数据的 JSONPath 表达式 */
+    dataPath?: string;
+    /** 字段映射 { 新字段名: 原字段路径 } */
+    fieldMapping?: Record<string, string>;
+    /** 是否展平嵌套对象 */
+    flatten?: boolean;
+}
+/**
+ * 认证配置
+ */
+export interface AuthConfig {
+    /** 认证类型 */
+    type: 'none' | 'bearer' | 'basic' | 'apikey' | 'custom';
+    /** Bearer Token */
+    token?: string;
+    /** Basic Auth 用户名 */
+    username?: string;
+    /** Basic Auth 密码 */
+    password?: string;
+    /** API Key 名称 */
+    apiKeyName?: string;
+    /** API Key 值 */
+    apiKeyValue?: string;
+    /** API Key 位置 */
+    apiKeyIn?: 'header' | 'query';
+    /** 自定义请求头 */
+    customHeaders?: Record<string, string>;
+}
+/**
+ * API 工具配置定义
+ */
+export interface ApiToolConfig {
+    /** 工具唯一标识 */
+    name: string;
+    /** 工具标题 */
+    title?: string;
+    /** 工具描述 */
+    description: string;
+    /** HTTP 方法 */
+    method: HttpMethod;
+    /** API 基础 URL */
+    baseUrl: string;
+    /** API 路径(可包含路径参数,如 /users/{userId}) */
+    path: string;
+    /** 参数定义列表 */
+    parameters?: ApiParameter[];
+    /** 请求体定义 */
+    requestBody?: ApiRequestBody;
+    /** 默认请求头 */
+    headers?: Record<string, string>;
+    /** 认证配置 */
+    auth?: AuthConfig;
+    /** 预处理器名称 - 指定使用哪个预处理器 */
+    preprocessor?: string;
+    /** 响应转换配置 */
+    responseTransform?: ResponseTransform;
+    /** 超时时间(毫秒) */
+    timeout?: number;
+    /** 是否启用 */
+    enabled?: boolean;
+}
+/**
+ * API 工具配置文件格式
+ */
+export interface ApiToolsConfigFile {
+    /** 配置文件版本 */
+    version: string;
+    /** 全局配置 */
+    globals?: {
+        baseUrl?: string;
+        timeout?: number;
+        headers?: Record<string, string>;
+        auth?: AuthConfig;
+    };
+    /** API 工具列表 */
+    tools: ApiToolConfig[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/tools/api/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/tools/api/types.ts"],"names":[],"mappings":"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"}

package/dist/src/tools/api/types.js

@@ -0,0 +1,5 @@
+/**
+ * API 工具类型定义
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/tools/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/tools/api/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/tools/examples/echo.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Echo 工具 - 简单回显输入内容
+ */
+import { type ToolConfig } from '../types.js';
+export declare const echoTool: ToolConfig;
+//# sourceMappingURL=echo.d.ts.map

package/dist/src/tools/examples/echo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo.d.ts","sourceRoot":"","sources":["../../../../src/tools/examples/echo.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,UA8DtB,CAAC"}

package/dist/src/tools/examples/echo.js

@@ -0,0 +1,61 @@
+/**
+ * Echo 工具 - 简单回显输入内容
+ */
+export const echoTool = {
+    name: 'echo',
+    title: 'Echo Tool',
+    description: 'Echoes back the input message. Useful for testing the MCP server.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            message: {
+                type: 'string',
+                description: 'The message to echo back',
+            },
+            uppercase: {
+                type: 'boolean',
+                description: 'Whether to convert the message to uppercase',
+            },
+        },
+        required: ['message'],
+    },
+    outputSchema: {
+        type: 'object',
+        properties: {
+            original: {
+                type: 'string',
+                description: 'The original message',
+            },
+            echoed: {
+                type: 'string',
+                description: 'The echoed message',
+            },
+            timestamp: {
+                type: 'string',
+                description: 'Timestamp of the echo',
+            },
+        },
+        required: ['original', 'echoed', 'timestamp'],
+    },
+    handler: (args, context) => {
+        const message = args.message;
+        const uppercase = args.uppercase;
+        const echoed = uppercase ? message.toUpperCase() : message;
+        const timestamp = new Date(context.timestamp).toISOString();
+        const result = {
+            original: message,
+            echoed,
+            timestamp,
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Echo: ${echoed}`,
+                },
+            ],
+            structuredContent: result,
+        };
+    },
+};
+//# sourceMappingURL=echo.js.map

package/dist/src/tools/examples/echo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo.js","sourceRoot":"","sources":["../../../../src/tools/examples/echo.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,QAAQ,GAAe;IAClC,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,WAAW;IAClB,WAAW,EAAE,mEAAmE;IAEhF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0BAA0B;aACxC;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,6CAA6C;aAC3D;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IAED,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sBAAsB;aACpC;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oBAAoB;aAClC;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uBAAuB;aACrC;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC;KAC9C;IAED,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAiB,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAgC,CAAC;QAExD,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC3D,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAE5D,MAAM,MAAM,GAAG;YACb,QAAQ,EAAE,OAAO;YACjB,MAAM;YACN,SAAS;SACV,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,SAAS,MAAM,EAAE;iBACxB;aACF;YACD,iBAAiB,EAAE,MAAM;SAC1B,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/src/tools/types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 工具类型定义
+ */
+/**
+ * 工具处理器执行上下文
+ */
+export interface ToolContext {
+    /** 会话 ID */
+    sessionId?: string;
+    /** 请求元数据 */
+    metadata?: Record<string, unknown>;
+    /** 工具调用的时间戳 */
+    timestamp: number;
+}
+/**
+ * 工具执行结果
+ */
+export interface ToolResult {
+    /** 文本内容数组,用于 LLM 展示 */
+    content: {
+        type: 'text' | 'image' | 'resource';
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }[];
+    /** 结构化数据对象(可选),符合 outputSchema */
+    structuredContent?: Record<string, unknown>;
+    /** 是否为错误结果 */
+    isError?: boolean;
+}
+/**
+ * 工具处理器函数类型
+ */
+export type ToolHandler = (args: Record<string, unknown>, context: ToolContext) => Promise<ToolResult> | ToolResult;
+/**
+ * 工具配置定义
+ */
+export interface ToolConfig {
+    /** 工具唯一标识符 */
+    name: string;
+    /** 工具的可读标题 */
+    title?: string;
+    /** 工具功能描述 */
+    description: string;
+    /** 输入参数的 JSON Schema */
+    inputSchema: Record<string, unknown>;
+    /** 输出结果的 JSON Schema(可选) */
+    outputSchema?: Record<string, unknown>;
+    /** 工具的业务逻辑处理函数 */
+    handler: ToolHandler;
+}
+/**
+ * 传输模式类型
+ */
+export type TransportMode = 'stdio' | 'sse' | 'http';
+/**
+ * 服务配置
+ */
+export interface ServerConfig {
+    /** 服务名称 */
+    name: string;
+    /** 服务版本 */
+    version: string;
+    /** 传输模式 */
+    transport?: TransportMode;
+    /** HTTP 端口(HTTP/SSE 模式) */
+    port?: number;
+    /** 会话超时时间(毫秒) */
+    sessionTimeout?: number;
+    /** 日志级别 */
+    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+    /** 工具配置数组 */
+    tools?: ToolConfig[];
+}
+/**
+ * 中间件函数类型
+ */
+export type Middleware = (context: ToolContext, next: () => Promise<ToolResult>) => Promise<ToolResult>;
+/**
+ * 会话状态
+ */
+export declare enum SessionStatus {
+    UNINITIALIZED = "uninitialized",
+    INITIALIZED = "initialized",
+    ACTIVE = "active",
+    TIMEOUT = "timeout",
+    CLOSED = "closed"
+}
+/**
+ * 会话信息
+ */
+export interface Session {
+    /** 会话 ID */
+    id: string;
+    /** 会话状态 */
+    status: SessionStatus;
+    /** 创建时间 */
+    createdAt: number;
+    /** 最后活跃时间 */
+    lastActiveAt: number;
+    /** 会话上下文数据 */
+    context: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uBAAuB;IACvB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;QACpC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,EAAE,CAAC;IACJ,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,cAAc;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,kBAAkB;IAClB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW;IACX,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/C,aAAa;IACb,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CACvB,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,KAC5B,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB;;GAEG;AACH,oBAAY,aAAa;IACvB,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;IAC3B,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,WAAW;IACX,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC"}

package/dist/src/tools/types.js

@@ -0,0 +1,15 @@
+/**
+ * 工具类型定义
+ */
+/**
+ * 会话状态
+ */
+export var SessionStatus;
+(function (SessionStatus) {
+    SessionStatus["UNINITIALIZED"] = "uninitialized";
+    SessionStatus["INITIALIZED"] = "initialized";
+    SessionStatus["ACTIVE"] = "active";
+    SessionStatus["TIMEOUT"] = "timeout";
+    SessionStatus["CLOSED"] = "closed";
+})(SessionStatus || (SessionStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/src/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA0FH;;GAEG;AACH,MAAM,CAAN,IAAY,aAMX;AAND,WAAY,aAAa;IACvB,gDAA+B,CAAA;IAC/B,4CAA2B,CAAA;IAC3B,kCAAiB,CAAA;IACjB,oCAAmB,CAAA;IACnB,kCAAiB,CAAA;AACnB,CAAC,EANW,aAAa,KAAb,aAAa,QAMxB"}

package/dist/src/tools/validator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Schema 验证器
+ */
+import { type ZodSchema } from 'zod';
+/**
+ * JSON Schema 转 Zod Schema 的辅助函数
+ */
+export declare class SchemaValidator {
+    /**
+     * 从 JSON Schema 创建 Zod Schema
+     * 注意:这是一个简化的实现,仅支持基本类型
+     */
+    static createZodSchema(jsonSchema: Record<string, unknown>): ZodSchema;
+    /**
+     * 验证输入数据
+     */
+    static validateInput(data: unknown, schema: Record<string, unknown>): Record<string, unknown>;
+    /**
+     * 验证输出数据(宽松模式,只记录警告)
+     */
+    static validateOutput(data: unknown, schema: Record<string, unknown>): boolean;
+    /**
+     * 验证 JSON Schema 本身的有效性
+     */
+    static isValidSchema(schema: Record<string, unknown>): boolean;
+}
+//# sourceMappingURL=validator.d.ts.map

package/dist/src/tools/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/tools/validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAK,KAAK,SAAS,EAAY,MAAM,KAAK,CAAC;AAIlD;;GAEG;AACH,qBAAa,eAAe;IAC1B;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAwEtE;;OAEG;IACH,MAAM,CAAC,aAAa,CAClB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAqB1B;;OAEG;IACH,MAAM,CAAC,cAAc,CACnB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO;IAoBV;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;CAc/D"}