@cicctencent/agent-server 0.1.1

package/dist/esm/mcp/api-bridge-client.js

@@ -0,0 +1,139 @@
+// ============================================================
+// ApiBridgeClient — 通用 HTTP API → MCP 桥接客户端
+// 属于应用层 MCP 扩展（server/mcp），非 core 协议实现
+//
+// 纯粹的执行器：不包含任何请求构建逻辑，
+// 通过 extra.buildRequest 委托给连接器的 RequestBuilderFn。
+// ============================================================
+import { resolveProxyAgentForCategory } from '@cicctencent/agent-core';
+import { JSONPath } from 'jsonpath-plus';
+/**
+ * API Bridge 客户端
+ *
+ * 纯粹的 fetch 执行器，不含任何请求构建逻辑。
+ * 连接器通过 RequestBuilderFn 定义如何构建 HTTP 请求（URL、headers、body、代理等），
+ * ApiBridgeClient 仅负责：调用 buildRequest → 执行 fetch → 返回结果。
+ */
+export class ApiBridgeClient {
+    config;
+    extra;
+    connected = false;
+    proxyUrl;
+    async connect(config) {
+        const extra = config.extra;
+        if (!extra?.buildRequest) {
+            throw new Error('api-bridge transport requires "buildRequest" function in config.extra');
+        }
+        if (!extra?.apiMapping || Object.keys(extra.apiMapping).length === 0) {
+            throw new Error('api-bridge transport requires "apiMapping" in config.extra');
+        }
+        this.config = config;
+        this.extra = extra;
+        // 创建代理 dispatcher（根据 proxySettings.mcp 分类配置解析）
+        this.proxyUrl = resolveProxyAgentForCategory(config.proxyCategory, 'ApiBridge');
+        this.connected = true;
+        console.log(`[ApiBridge][${config.name}] connected — mappingKeys=${Object.keys(extra.apiMapping).join(', ')}${this.proxyUrl ? ' (proxy enabled)' : ''}`);
+    }
+    async listTools() {
+        const toolDefs = this.extra.toolDefinitions || [];
+        return toolDefs.map(t => ({
+            type: 'function',
+            function: {
+                name: t.name,
+                description: t.description || '',
+                parameters: (t.parameters || { type: 'object', properties: {} }),
+            },
+        }));
+    }
+    async callTool(name, args) {
+        const mapping = this.extra.apiMapping?.[name];
+        if (!mapping) {
+            console.error(`[ApiBridge][${this.config.name}] callTool('${name}') FAILED — no apiMapping entry`);
+            throw new Error(`Unknown tool: ${name} (no apiMapping entry)`);
+        }
+        // 委托 builder 构建完整的 fetch 请求参数
+        const { url, init } = await this.extra.buildRequest({
+            toolName: name,
+            args,
+            mapping,
+            extra: this.config.extra,
+        });
+        console.log(`[ApiBridge][${this.config.name}] callTool('${name}')`);
+        console.log(`  -> ${init.method || 'POST'} ${url}`);
+        if (init.body) {
+            const bodyStr = typeof init.body === 'string' ? init.body : JSON.stringify(init.body);
+            console.log(`  -> Body: ${bodyStr.length > 500 ? bodyStr.substring(0, 500) + '...' : bodyStr}`);
+        }
+        // 执行 fetch（含超时控制）
+        const timeout = this.config.timeout || 30000;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeout);
+        const startTime = Date.now();
+        try {
+            const fetchOptions = {
+                ...init,
+                signal: controller.signal,
+            };
+            if (this.proxyUrl)
+                fetchOptions.proxy = this.proxyUrl;
+            const res = await fetch(url, fetchOptions);
+            const duration = Date.now() - startTime;
+            console.log(`  <- Status: ${res.status} ${res.statusText} (${duration}ms)`);
+            if (!res.ok) {
+                const errBody = await res.text().catch(() => '');
+                console.error(`  <- Error Body: ${errBody}`);
+                throw new Error(`API request failed: ${res.status} ${res.statusText} — ${errBody}`);
+            }
+            const data = await res.json();
+            // 响应处理管道：业务错误检测 + JSONPath 数据提取
+            const responseConfig = mapping['response'] ?? this.extra.response;
+            let result = data;
+            if (responseConfig) {
+                // 1. 业务错误检测
+                if (responseConfig.errorField) {
+                    const errValues = JSONPath({ path: responseConfig.errorField, json: data, wrap: true });
+                    const errCode = errValues?.[0];
+                    if (errCode !== undefined && errCode !== null && errCode !== 0 && errCode !== '') {
+                        let errMsg = '';
+                        if (responseConfig.errorMessage) {
+                            const msgValues = JSONPath({ path: responseConfig.errorMessage, json: data, wrap: true });
+                            errMsg = msgValues?.[0] || '';
+                        }
+                        throw new Error(`Business error [${errCode}]: ${errMsg}`);
+                    }
+                }
+                // 2. JSONPath 数据提取
+                if (responseConfig.extract) {
+                    const extracted = JSONPath({ path: responseConfig.extract, json: data, wrap: true });
+                    result = extracted?.length === 1 ? extracted[0] : (extracted || []);
+                }
+            }
+            const resultStr = JSON.stringify(result, null, 2);
+            console.log(`  <- Response (${resultStr.length} chars): ${resultStr.substring(0, 500)}${resultStr.length > 500 ? '...' : ''}`);
+            return resultStr;
+        }
+        catch (e) {
+            const duration = Date.now() - startTime;
+            if (e.name === 'AbortError') {
+                console.error(`  [x] Timed out after ${timeout}ms`);
+                throw new Error(`API request timed out after ${timeout}ms`);
+            }
+            console.error(`  [x] Failed (${duration}ms): ${e?.message || e}`);
+            if (e.cause) {
+                console.error(`  [x] Cause: ${e.cause?.message || e.cause}`);
+            }
+            throw e;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    disconnect() {
+        this.proxyUrl = undefined;
+        this.connected = false;
+    }
+    isConnected() {
+        return this.connected;
+    }
+}
+//# sourceMappingURL=api-bridge-client.js.map

package/dist/esm/mcp/api-bridge-client.js.map

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

package/dist/esm/mcp/api-bridge-types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @file API Bridge 类型定义 — RequestBuilder 接口 + 认证 + 响应处理
+ * @description 定义 ApiBridgeClient 与请求构建函数之间的通用契约。
+ *              连接器通过 requestBuilderId 指定使用哪个 builder 构建 fetch 请求参数。
+ */
+/** 构建请求函数的输入上下文 */
+export interface BuildRequestContext {
+    /** 工具名称 */
+    toolName: string;
+    /** 工具调用参数 */
+    args: Record<string, unknown>;
+    /** apiMapping 中该工具的配置项 */
+    mapping: Record<string, unknown>;
+    /** 扩展配置（从 MCPServerConfig.extra 透传） */
+    extra: Record<string, unknown>;
+}
+/** 构建请求函数的返回值 — fetch 所需的完整参数 */
+export interface FetchRequestOptions {
+    /** 请求 URL */
+    url: string;
+    /** fetch 初始化选项 */
+    init: RequestInit;
+}
+/**
+ * 请求构建函数
+ *
+ * 由连接器定义，负责将工具调用参数转换为完整的 fetch 请求。
+ * ApiBridgeClient 仅作为执行器调用此函数并发送返回的请求。
+ */
+export type RequestBuilderFn = (ctx: BuildRequestContext) => Promise<FetchRequestOptions>;
+/**
+ * 认证配置
+ *
+ * 支持四种认证方式：
+ * - `bearer`: HTTP Bearer Token（Authorization: Bearer xxx）
+ * - `basic`:  HTTP Basic Auth（Authorization: Basic base64(user:pass)）
+ * - `apiKey`: 自定义 API Key Header（如 X-API-Key: xxx）
+ * - `custom`: 完全自定义 Header 名和值
+ *
+ * value 支持 `${env.VAR_NAME}` 模板，运行时从环境变量读取敏感凭证。
+ */
+export interface AuthConfig {
+    /** 认证方式 */
+    type: 'bearer' | 'basic' | 'apiKey' | 'custom';
+    /**
+     * 认证凭证值
+     * - bearer: token 值
+     * - basic: base64(user:pass) 编码值
+     * - apiKey: key 值
+     * - custom: header 值
+     * 支持 `${env.VAR_NAME}` 模板语法
+     */
+    value: string;
+    /** apiKey/custom 模式下的 header 名称（如 X-API-Key） */
+    name?: string;
+    /** 额外自定义 header 列表 */
+    extraHeaders?: {
+        name: string;
+        value: string;
+    }[];
+}
+/**
+ * 响应处理配置
+ *
+ * 控制 ApiBridgeClient 在 fetch 成功后如何加工响应数据：
+ * - `extract`: JSONPath 表达式提取有效数据（丢弃外层包装）
+ * - `errorField` + `errorMessage`: 业务错误码检测
+ *
+ * 示例：
+ * ```json
+ * {
+ *   "extract": "$.data.items",
+ *   "errorField": "$.errCode",
+ *   "errorMessage": "$.errMsg"
+ * }
+ * ```
+ * 当返回 `{ "errCode": 1001, "errMsg": "not found", "data": null }` 时，
+ * 自动抛出 `Business error [1001]: not found`
+ */
+export interface ResponseConfig {
+    /** JSONPath 表达式，提取有效数据（如 $.data.items），留空则返回完整响应 */
+    extract?: string;
+    /**
+     * 错误码字段路径（JSONPath 表达式，如 $.errCode）
+     * 当该字段值不为 0/null/undefined 时，视为业务错误并抛出异常
+     */
+    errorField?: string;
+    /** 错误消息字段路径（JSONPath 表达式，如 $.errMsg），与 errorField 配合使用 */
+    errorMessage?: string;
+}
+//# sourceMappingURL=api-bridge-types.d.ts.map

package/dist/esm/mcp/api-bridge-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-bridge-types.d.ts","sourceRoot":"","sources":["../../../src/mcp/api-bridge-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mBAAmB;AACnB,MAAM,WAAW,mBAAmB;IAClC,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,iCAAiC;AACjC,MAAM,WAAW,mBAAmB;IAClC,aAAa;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,kBAAkB;IAClB,IAAI,EAAE,WAAW,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAI1F;;;;;;;;;;GAUG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC/C;;;;;;;OAOG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAClD;AAID;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/esm/mcp/api-bridge-types.js

@@ -0,0 +1,7 @@
+/**
+ * @file API Bridge 类型定义 — RequestBuilder 接口 + 认证 + 响应处理
+ * @description 定义 ApiBridgeClient 与请求构建函数之间的通用契约。
+ *              连接器通过 requestBuilderId 指定使用哪个 builder 构建 fetch 请求参数。
+ */
+export {};
+//# sourceMappingURL=api-bridge-types.js.map

package/dist/esm/mcp/api-bridge-types.js.map

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

package/dist/esm/mcp/body-template.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @file Body 模板引擎 — 通用 ${param|default} 参数解析
+ * @description 将模板对象中的 ${param} / ${param|default} 占位符替换为实际参数值，
+ *              支持递归解析嵌套对象和数组，类型跟随默认值。
+ */
+/**
+ * 解析 body 模板：将 ${param|default} 替换为实际参数值
+ *
+ * 规则：
+ * - ${code}       → args.code（必须提供，否则返回空字符串）
+ * - ${market|0}   → args.market ?? '0'（可选，带默认值）
+ * - 类型跟随默认值：默认值是字符串则结果也是字符串，数字则数字
+ * - 非模板值（number, boolean, null）保持原样
+ */
+export declare function resolveBodyTemplate(template: Record<string, unknown>, args: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=body-template.d.ts.map

package/dist/esm/mcp/body-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-template.d.ts","sourceRoot":"","sources":["../../../src/mcp/body-template.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB"}

package/dist/esm/mcp/body-template.js

@@ -0,0 +1,59 @@
+/**
+ * @file Body 模板引擎 — 通用 ${param|default} 参数解析
+ * @description 将模板对象中的 ${param} / ${param|default} 占位符替换为实际参数值，
+ *              支持递归解析嵌套对象和数组，类型跟随默认值。
+ */
+/**
+ * 解析 body 模板：将 ${param|default} 替换为实际参数值
+ *
+ * 规则：
+ * - ${code}       → args.code（必须提供，否则返回空字符串）
+ * - ${market|0}   → args.market ?? '0'（可选，带默认值）
+ * - 类型跟随默认值：默认值是字符串则结果也是字符串，数字则数字
+ * - 非模板值（number, boolean, null）保持原样
+ */
+export function resolveBodyTemplate(template, args) {
+    const result = {};
+    for (const [key, val] of Object.entries(template)) {
+        result[key] = resolveValue(val, args);
+    }
+    return result;
+}
+function resolveValue(val, args) {
+    if (typeof val === 'string') {
+        return resolveString(val, args);
+    }
+    if (Array.isArray(val)) {
+        return val.map(v => resolveValue(v, args));
+    }
+    if (val !== null && typeof val === 'object') {
+        const obj = {};
+        for (const [k, v] of Object.entries(val)) {
+            obj[k] = resolveValue(v, args);
+        }
+        return obj;
+    }
+    return val; // number, boolean, null → 保持原样
+}
+/** 解析字符串中的 ${param|default} 模板 */
+function resolveString(str, args) {
+    // 整串匹配：整个字符串就是一个模板变量
+    const fullMatch = str.match(/^\$\{(\w+)(?:\|([^}]*))?\}$/);
+    if (fullMatch) {
+        const [, paramName, defaultStr] = fullMatch;
+        if (args[paramName] !== undefined && args[paramName] !== null) {
+            // 如果默认值是字符串，将参数转为字符串
+            return defaultStr !== undefined ? String(args[paramName]) : args[paramName];
+        }
+        // 使用默认值
+        return defaultStr !== undefined ? defaultStr : '';
+    }
+    // 部分替换：字符串中包含多个 ${} 模板
+    return str.replace(/\$\{(\w+)(?:\|([^}]*))?\}/g, (_, paramName, defaultStr) => {
+        if (args[paramName] !== undefined && args[paramName] !== null) {
+            return String(args[paramName]);
+        }
+        return defaultStr !== undefined ? defaultStr : '';
+    });
+}
+//# sourceMappingURL=body-template.js.map

package/dist/esm/mcp/body-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-template.js","sourceRoot":"","sources":["../../../src/mcp/body-template.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAiC,EACjC,IAA6B;IAE7B,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,GAAY,EAAE,IAA6B;IAC/D,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;YACpE,GAAG,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,GAAG,CAAC,CAAC,+BAA+B;AAC7C,CAAC;AAED,kCAAkC;AAClC,SAAS,aAAa,CAAC,GAAW,EAAE,IAA6B;IAC/D,qBAAqB;IACrB,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC3D,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,GAAG,SAAS,CAAC;QAC5C,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;YAC9D,qBAAqB;YACrB,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9E,CAAC;QACD,QAAQ;QACR,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,CAAC;IACD,uBAAuB;IACvB,OAAO,GAAG,CAAC,OAAO,CAAC,4BAA4B,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE;QAC5E,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;YAC9D,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/mcp/openapi-importer.d.ts

@@ -0,0 +1,24 @@
+import type { MCPToolDefinition } from '../types.js';
+/** OpenAPI 导入结果 */
+export interface OpenAPIImportResult {
+    /** 生成的 MCP 工具定义列表 */
+    toolDefinitions: MCPToolDefinition[];
+    /** 生成的 apiMapping（工具名 → 请求映射配置） */
+    apiMapping: Record<string, Record<string, unknown>>;
+}
+/** 导入选项 */
+export interface OpenAPIImportOptions {
+    /** 工具名前缀（如 "petstore_"），避免多 spec 命名冲突 */
+    prefix?: string;
+    /** 仅导入包含指定 tag 的 operation */
+    tagFilter?: string[];
+}
+/**
+ * 从 OpenAPI spec（URL 或本地路径）自动导入工具定义和 apiMapping
+ *
+ * @param specUrlOrPath OpenAPI spec 的 URL 或本地文件路径
+ * @param options 导入选项
+ * @returns toolDefinitions + apiMapping
+ */
+export declare function importFromOpenAPI(specUrlOrPath: string, options?: OpenAPIImportOptions): Promise<OpenAPIImportResult>;
+//# sourceMappingURL=openapi-importer.d.ts.map

package/dist/esm/mcp/openapi-importer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-importer.d.ts","sourceRoot":"","sources":["../../../src/mcp/openapi-importer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,mBAAmB;AACnB,MAAM,WAAW,mBAAmB;IAClC,qBAAqB;IACrB,eAAe,EAAE,iBAAiB,EAAE,CAAC;IACrC,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAED,WAAW;AACX,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAqE9B"}

package/dist/esm/mcp/openapi-importer.js

@@ -0,0 +1,177 @@
+// ============================================================
+// OpenAPI Importer — 从 OpenAPI 3.x / Swagger 2.0 spec 自动生成 MCP 工具定义
+// ============================================================
+import SwaggerParser from '@apidevtools/swagger-parser';
+/**
+ * 从 OpenAPI spec（URL 或本地路径）自动导入工具定义和 apiMapping
+ *
+ * @param specUrlOrPath OpenAPI spec 的 URL 或本地文件路径
+ * @param options 导入选项
+ * @returns toolDefinitions + apiMapping
+ */
+export async function importFromOpenAPI(specUrlOrPath, options) {
+    const api = await SwaggerParser.dereference(specUrlOrPath);
+    const paths = api.paths || {};
+    const prefix = options?.prefix || '';
+    const tagFilter = options?.tagFilter;
+    const toolDefinitions = [];
+    const apiMapping = {};
+    for (const [pathStr, pathItem] of Object.entries(paths)) {
+        if (!pathItem || typeof pathItem !== 'object')
+            continue;
+        for (const method of ['get', 'post', 'put', 'delete', 'patch']) {
+            const operation = pathItem[method];
+            if (!operation)
+                continue;
+            // tag 过滤
+            if (tagFilter?.length) {
+                const opTags = operation.tags || [];
+                if (!opTags.some(t => tagFilter.includes(t)))
+                    continue;
+            }
+            // 1. 生成工具名
+            const rawName = operation.operationId || generateToolName(method, pathStr);
+            const toolName = prefix + sanitizeName(rawName);
+            // 2. 生成 description
+            const description = operation.summary || operation.description || `${method.toUpperCase()} ${pathStr}`;
+            // 3. 生成 parameters schema
+            const { properties, required } = buildParameterSchema(operation, pathItem, pathStr);
+            const parameters = {
+                type: 'object',
+                properties,
+                ...(required.length > 0 ? { required } : {}),
+            };
+            toolDefinitions.push({ name: toolName, description, parameters });
+            // 4. 生成 apiMapping 条目
+            const entry = pathStr.startsWith('/') ? pathStr.slice(1) : pathStr;
+            const mapping = {
+                entry,
+                method: method.toUpperCase(),
+            };
+            // body 模板（POST/PUT/PATCH → requestBody properties）
+            if (['post', 'put', 'patch'].includes(method)) {
+                const bodyTemplate = buildBodyTemplate(operation);
+                if (bodyTemplate && Object.keys(bodyTemplate).length > 0) {
+                    mapping.body = bodyTemplate;
+                }
+            }
+            // query/path 参数 → body 模板（GET/DELETE → query string 化）
+            if (['get', 'delete'].includes(method)) {
+                const queryTemplate = buildQueryTemplate(operation, pathItem, pathStr);
+                if (queryTemplate && Object.keys(queryTemplate).length > 0) {
+                    mapping.body = queryTemplate;
+                }
+            }
+            apiMapping[toolName] = mapping;
+        }
+    }
+    console.log(`[OpenAPI:Import] ${specUrlOrPath}: ${toolDefinitions.length} tools generated`);
+    return { toolDefinitions, apiMapping };
+}
+// ===== 内部辅助函数 =====
+/**
+ * 从 HTTP method + path 自动生成工具名
+ * GET /users/{id} → get_users_by_id
+ */
+function generateToolName(method, path) {
+    const parts = path.split('/').filter(Boolean).map(segment => {
+        if (segment.startsWith('{') && segment.endsWith('}')) {
+            return 'by_' + segment.slice(1, -1);
+        }
+        return segment;
+    });
+    return `${method}_${parts.join('_')}`;
+}
+/** 清理名称为合法标识符（仅保留字母、数字、下划线） */
+function sanitizeName(name) {
+    return name.replace(/[^a-zA-Z0-9_]/g, '_').replace(/_+/g, '_').replace(/^_|_$/g, '');
+}
+/**
+ * 从 operation 的 parameters + requestBody 构建 JSON Schema
+ */
+function buildParameterSchema(operation, pathItem, pathStr) {
+    const properties = {};
+    const required = [];
+    // 合并 path-level + operation-level parameters
+    const allParams = [
+        ...(pathItem.parameters || []),
+        ...(operation.parameters || []),
+    ];
+    for (const param of allParams) {
+        const name = param.name;
+        if (!name)
+            continue;
+        const schema = param.schema || {};
+        properties[name] = {
+            type: schema.type || 'string',
+            description: param.description || `${param.in} parameter: ${name}`,
+            ...(schema.enum ? { enum: schema.enum } : {}),
+        };
+        if (param.required) {
+            required.push(name);
+        }
+    }
+    // requestBody → 提取顶层 properties
+    const requestBody = operation.requestBody;
+    if (requestBody) {
+        const content = requestBody.content || {};
+        const mediaType = content['application/json'] || content['application/x-www-form-urlencoded'] || Object.values(content)[0];
+        if (mediaType?.schema?.properties) {
+            for (const [propName, propSchema] of Object.entries(mediaType.schema.properties)) {
+                if (!properties[propName]) {
+                    const ps = propSchema;
+                    properties[propName] = {
+                        type: ps.type || 'string',
+                        description: ps.description || '',
+                        ...(ps.enum ? { enum: ps.enum } : {}),
+                    };
+                }
+            }
+            if (mediaType.schema.required?.length) {
+                for (const r of mediaType.schema.required) {
+                    if (!required.includes(r))
+                        required.push(r);
+                }
+            }
+        }
+        if (requestBody.required && required.length === 0) {
+            // requestBody 整体 required 但无具体字段，跳过
+        }
+    }
+    return { properties, required };
+}
+/**
+ * 从 requestBody 构建 POST body 模板（${param} 占位符）
+ */
+function buildBodyTemplate(operation) {
+    const requestBody = operation.requestBody;
+    if (!requestBody)
+        return undefined;
+    const content = requestBody.content || {};
+    const mediaType = content['application/json'] || Object.values(content)[0];
+    if (!mediaType?.schema?.properties)
+        return undefined;
+    const template = {};
+    for (const propName of Object.keys(mediaType.schema.properties)) {
+        template[propName] = `\${${propName}}`;
+    }
+    return template;
+}
+/**
+ * 从 query/path parameters 构建 GET query 模板
+ */
+function buildQueryTemplate(operation, pathItem, pathStr) {
+    const allParams = [
+        ...(pathItem.parameters || []),
+        ...(operation.parameters || []),
+    ];
+    const queryParams = allParams.filter((p) => p.in === 'query');
+    if (queryParams.length === 0)
+        return undefined;
+    const template = {};
+    for (const param of queryParams) {
+        template[param.name] = `\${${param.name}}`;
+    }
+    return template;
+}
+//# sourceMappingURL=openapi-importer.js.map

package/dist/esm/mcp/openapi-importer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-importer.js","sourceRoot":"","sources":["../../../src/mcp/openapi-importer.ts"],"names":[],"mappings":"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"}

package/dist/esm/mcp/template-builder.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @file 通用模板请求构建器
+ * @description 配置驱动的 HTTP 请求构建，从 manifest/extra 中读取 URL 模板、body 模板、relay、认证和响应配置。
+ *              适用于所有“模板化 HTTP API → MCP”的连接器，无需编写连接器专属 builder 代码。
+ *
+ * 配置字段（来自 MCPServerEntity / manifest extra）：
+ * - urlTemplate: URL 构建模板，支持 {apiRoot} {entry} 占位符
+ * - apiRoot:     API 根 URL
+ * - apiMapping:  工具名 → { entry, body, method?, url? } 映射
+ * - relay:       可选的业务级代理转发配置（url + headers，通过 target-url header 转发）
+ * - auth:        可选的认证配置（bearer/basic/apiKey/custom）
+ * - response:    可选的响应处理配置（JSONPath 提取 + 错误码检测）
+ *
+ * 映射扩展字段：
+ * - method:  'GET' | 'POST'（默认 'POST'）
+ * - url:     直接覆盖 urlTemplate（支持 {apiRoot} 占位符）
+ * - entry:   支持 ${param} 路径参数（如 v8/finance/chart/${symbol}）
+ */
+import type { RequestBuilderFn, AuthConfig, ResponseConfig } from './api-bridge-types.js';
+/** 通用模板构建器的 extra 配置结构 */
+export interface TemplateBuilderExtra {
+    /** API 根 URL */
+    apiRoot: string;
+    /** URL 构建模板，支持 {apiRoot} 和 {entry} 占位符 */
+    urlTemplate: string;
+    /** 工具名 → 映射配置（含 entry + body 模板 + 可选 method/url） */
+    apiMapping: Record<string, {
+        entry: string;
+        body?: Record<string, unknown>;
+        /** HTTP 方法，默认 'POST' */
+        method?: 'GET' | 'POST';
+        /** 直接覆盖 urlTemplate（支持 {apiRoot} 占位符） */
+        url?: string;
+    }>;
+    /**
+     * 业务级代理转发配置（可选）
+     *
+     * 与网络级 `proxy`（undici ProxyAgent）不同，
+     * relay 通过 HTTP header（target-url / target-headers）将请求转发给中间服务。
+     */
+    relay?: {
+        url: string;
+        headers?: Record<string, string>;
+    };
+    /** 认证配置（支持 bearer/basic/apiKey/custom） */
+    auth?: AuthConfig;
+    /** 全局响应处理配置（可被 mapping 级 response 覆盖） */
+    response?: ResponseConfig;
+    /** 自定义默认请求头（如 User-Agent），连接器级可覆盖全局默认 */
+    headers?: Record<string, string>;
+}
+export declare const buildFromTemplate: RequestBuilderFn;
+//# sourceMappingURL=template-builder.d.ts.map

package/dist/esm/mcp/template-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-builder.d.ts","sourceRoot":"","sources":["../../../src/mcp/template-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG1F,0BAA0B;AAC1B,MAAM,WAAW,oBAAoB;IACnC,gBAAgB;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QACzB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,wBAAwB;QACxB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;QACxB,yCAAyC;QACzC,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH;;;;;OAKG;IACH,KAAK,CAAC,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC;IACF,0CAA0C;IAC1C,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAmDD,eAAO,MAAM,iBAAiB,EAAE,gBA2G/B,CAAC"}