api2mcp 0.5.0 → 0.6.0

package/dist/index.d.mts

@@ -29,6 +29,8 @@ interface ApiSourceConfig {
     toolPrefix?: string;
     /** 工作模式：default（默认）或 ondemand（按需） */
     mode?: Mode;
+    /** 固定参数（预填充到路径/查询参数中，不暴露给 LLM） */
+    fixedParams?: Record<string, string>;
 }
 /**
  * 完整配置
@@ -45,6 +47,7 @@ declare const CliArgsSchema: z.ZodObject<{
     baseUrl: z.ZodOptional<z.ZodString>;
     timeout: z.ZodOptional<z.ZodNumber>;
     headers: z.ZodOptional<z.ZodString>;
+    fixedParams: z.ZodOptional<z.ZodString>;
     prefix: z.ZodOptional<z.ZodString>;
     debug: z.ZodOptional<z.ZodBoolean>;
     mode: z.ZodOptional<z.ZodEnum<["default", "ondemand"]>>;
@@ -54,6 +57,7 @@ declare const CliArgsSchema: z.ZodObject<{
     baseUrl?: string | undefined;
     timeout?: number | undefined;
     headers?: string | undefined;
+    fixedParams?: string | undefined;
     prefix?: string | undefined;
     mode?: "default" | "ondemand" | undefined;
 }, {
@@ -62,6 +66,7 @@ declare const CliArgsSchema: z.ZodObject<{
     baseUrl?: string | undefined;
     timeout?: number | undefined;
     headers?: string | undefined;
+    fixedParams?: string | undefined;
     prefix?: string | undefined;
     mode?: "default" | "ondemand" | undefined;
 }>;
@@ -74,6 +79,7 @@ interface EnvConfig {
     API_BASE_URL?: string;
     API_TIMEOUT?: string;
     API_HEADERS?: string;
+    API_FIXED_PARAMS?: string;
     DEBUG?: string;
 }
 
@@ -258,11 +264,11 @@ interface GeneratedTool {
 /**
  * 从 OpenAPI 操作生成 MCP 工具
  */
-declare function generateTool(operation: OpenApiOperation, components?: Record<string, OpenApiSchema>, toolPrefix?: string): GeneratedTool;
+declare function generateTool(operation: OpenApiOperation, components?: Record<string, OpenApiSchema>, toolPrefix?: string, fixedParams?: Record<string, string>): GeneratedTool;
 /**
  * 批量生成工具
  */
-declare function generateTools(operations: OpenApiOperation[], components?: Record<string, OpenApiSchema>, toolPrefix?: string): GeneratedTool[];
+declare function generateTools(operations: OpenApiOperation[], components?: Record<string, OpenApiSchema>, toolPrefix?: string, fixedParams?: Record<string, string>): GeneratedTool[];
 
 /**
  * HTTP 客户端

package/dist/index.d.ts

@@ -29,6 +29,8 @@ interface ApiSourceConfig {
     toolPrefix?: string;
     /** 工作模式：default（默认）或 ondemand（按需） */
     mode?: Mode;
+    /** 固定参数（预填充到路径/查询参数中，不暴露给 LLM） */
+    fixedParams?: Record<string, string>;
 }
 /**
  * 完整配置
@@ -45,6 +47,7 @@ declare const CliArgsSchema: z.ZodObject<{
     baseUrl: z.ZodOptional<z.ZodString>;
     timeout: z.ZodOptional<z.ZodNumber>;
     headers: z.ZodOptional<z.ZodString>;
+    fixedParams: z.ZodOptional<z.ZodString>;
     prefix: z.ZodOptional<z.ZodString>;
     debug: z.ZodOptional<z.ZodBoolean>;
     mode: z.ZodOptional<z.ZodEnum<["default", "ondemand"]>>;
@@ -54,6 +57,7 @@ declare const CliArgsSchema: z.ZodObject<{
     baseUrl?: string | undefined;
     timeout?: number | undefined;
     headers?: string | undefined;
+    fixedParams?: string | undefined;
     prefix?: string | undefined;
     mode?: "default" | "ondemand" | undefined;
 }, {
@@ -62,6 +66,7 @@ declare const CliArgsSchema: z.ZodObject<{
     baseUrl?: string | undefined;
     timeout?: number | undefined;
     headers?: string | undefined;
+    fixedParams?: string | undefined;
     prefix?: string | undefined;
     mode?: "default" | "ondemand" | undefined;
 }>;
@@ -74,6 +79,7 @@ interface EnvConfig {
     API_BASE_URL?: string;
     API_TIMEOUT?: string;
     API_HEADERS?: string;
+    API_FIXED_PARAMS?: string;
     DEBUG?: string;
 }
 
@@ -258,11 +264,11 @@ interface GeneratedTool {
 /**
  * 从 OpenAPI 操作生成 MCP 工具
  */
-declare function generateTool(operation: OpenApiOperation, components?: Record<string, OpenApiSchema>, toolPrefix?: string): GeneratedTool;
+declare function generateTool(operation: OpenApiOperation, components?: Record<string, OpenApiSchema>, toolPrefix?: string, fixedParams?: Record<string, string>): GeneratedTool;
 /**
  * 批量生成工具
  */
-declare function generateTools(operations: OpenApiOperation[], components?: Record<string, OpenApiSchema>, toolPrefix?: string): GeneratedTool[];
+declare function generateTools(operations: OpenApiOperation[], components?: Record<string, OpenApiSchema>, toolPrefix?: string, fixedParams?: Record<string, string>): GeneratedTool[];
 
 /**
  * HTTP 客户端

package/dist/index.js

@@ -163,6 +163,20 @@ function parseHeaders(headersStr) {
     );
   }
 }
+function parseFixedParams(paramsStr) {
+  if (!paramsStr) return void 0;
+  try {
+    const parsed = JSON.parse(paramsStr);
+    if (typeof parsed === "object" && parsed !== null) {
+      return parsed;
+    }
+    throw new Error("Fixed params must be a JSON object");
+  } catch (error) {
+    throw new ConfigurationError(
+      `Invalid fixedParams JSON: ${error instanceof Error ? error.message : "Unknown error"}`
+    );
+  }
+}
 function loadFromEnv(env) {
   const config = {};
   if (env.OPENAPI_URL) {
@@ -180,6 +194,9 @@ function loadFromEnv(env) {
   if (env.API_HEADERS) {
     config.headers = parseHeaders(env.API_HEADERS);
   }
+  if (env.API_FIXED_PARAMS) {
+    config.fixedParams = parseFixedParams(env.API_FIXED_PARAMS);
+  }
   if (env.DEBUG) {
     config.debug = env.DEBUG === "true" || env.DEBUG === "1";
   }
@@ -198,6 +215,7 @@ function loadFromFile(workingDir = process.cwd()) {
           baseUrl: parsed.baseUrl,
           timeout: parsed.timeout,
           headers: parsed.headers,
+          fixedParams: parsed.fixedParams,
           toolPrefix: parsed.toolPrefix,
           debug: parsed.debug,
           mode: parsed.mode
@@ -225,6 +243,9 @@ function loadFromCli(args) {
   if (args.headers) {
     config.headers = parseHeaders(args.headers);
   }
+  if (args.fixedParams) {
+    config.fixedParams = parseFixedParams(args.fixedParams);
+  }
   if (args.prefix) {
     config.toolPrefix = args.prefix;
   }
@@ -246,6 +267,7 @@ function mergeConfigs(...configs) {
     if (config.baseUrl !== void 0) merged.baseUrl = config.baseUrl;
     if (config.timeout !== void 0) merged.timeout = config.timeout;
     if (config.headers !== void 0) merged.headers = config.headers;
+    if (config.fixedParams !== void 0) merged.fixedParams = config.fixedParams;
     if (config.toolPrefix !== void 0) merged.toolPrefix = config.toolPrefix;
     if (config.debug !== void 0) merged.debug = config.debug;
     if (config.mode !== void 0) merged.mode = config.mode;
@@ -502,11 +524,14 @@ Tags: ${operation.tags.join(", ")}`);
   }
   return parts.join("\n");
 }
-function buildParametersSchema(operation, refResolver) {
+function buildParametersSchema(operation, refResolver, fixedParams) {
   const shape = {};
   if (operation.parameters) {
     for (const param of operation.parameters) {
       const paramName = param.name;
+      if (fixedParams && paramName in fixedParams) {
+        continue;
+      }
       let paramSchema = convertSchema(param.schema, refResolver);
       if (param.description) {
         paramSchema = paramSchema.describe(param.description);
@@ -547,11 +572,11 @@ function buildParametersSchema(operation, refResolver) {
   shape._baseUrl = import_zod2.z.string().url().optional().describe("API base URL (overrides the default). Example: https://api.example.com");
   return shape;
 }
-function generateTool(operation, components, toolPrefix) {
+function generateTool(operation, components, toolPrefix, fixedParams) {
   const refResolver = createRefResolver(components);
   const name = generateToolName(operation, toolPrefix);
   const description = generateToolDescription(operation);
-  const parametersShape = buildParametersSchema(operation, refResolver);
+  const parametersShape = buildParametersSchema(operation, refResolver, fixedParams);
   const inputSchema = import_zod2.z.object(parametersShape);
   logger.debug(`Generated tool: ${name}`);
   return {
@@ -561,11 +586,11 @@ function generateTool(operation, components, toolPrefix) {
     operation
   };
 }
-function generateTools(operations, components, toolPrefix) {
+function generateTools(operations, components, toolPrefix, fixedParams) {
   const tools = [];
   const usedNames = /* @__PURE__ */ new Set();
   for (const operation of operations) {
-    const tool = generateTool(operation, components, toolPrefix);
+    const tool = generateTool(operation, components, toolPrefix, fixedParams);
     if (usedNames.has(tool.name)) {
       let counter = 1;
       let newName = `${tool.name}_${counter}`;
@@ -598,11 +623,11 @@ function groupParametersByLocation(parameters) {
   }
   return groups;
 }
-function buildRequest(operation, input, defaultHeaders = {}) {
+function buildRequest(operation, input, defaultHeaders = {}, fixedParams = {}) {
   const groupedParams = groupParametersByLocation(operation.parameters);
   let path = operation.path;
   for (const param of groupedParams.path) {
-    const value = input[param.name];
+    const value = input[param.name] ?? fixedParams[param.name];
     if (value !== void 0) {
       path = path.replace(`{${param.name}}`, String(value));
     } else if (param.required) {
@@ -611,7 +636,7 @@ function buildRequest(operation, input, defaultHeaders = {}) {
   }
   const query = {};
   for (const param of groupedParams.query) {
-    const value = input[param.name];
+    const value = input[param.name] ?? fixedParams[param.name];
     if (value !== void 0) {
       if (Array.isArray(value)) {
         query[param.name] = value.map(String);
@@ -682,7 +707,7 @@ async function executeRequest(operation, input, config) {
     );
   }
   try {
-    const built = buildRequest(operation, input, config.headers || {});
+    const built = buildRequest(operation, input, config.headers || {}, config.fixedParams || {});
     let url = `${baseUrl}${built.path}`;
     url = appendQueryString(url, built.query);
     logger.info(`Executing: ${operation.method} ${url}`);
@@ -1713,7 +1738,7 @@ async function createServer(config) {
   logger.info(`Mode: ${config.mode || "default"}`);
   const server = new import_mcp.McpServer({
     name: "api2mcp",
-    version: "0.5.0"
+    version: "0.6.0"
   });
   const openApiDoc = await parseOpenApi(config.openapiUrl);
   const baseUrl = getBaseUrl(openApiDoc, config.baseUrl);
@@ -1724,7 +1749,8 @@ async function createServer(config) {
   const tools = generateTools(
     openApiDoc.operations,
     openApiDoc.components?.schemas,
-    config.toolPrefix
+    config.toolPrefix,
+    effectiveConfig.fixedParams
   );
   if (config.mode === "ondemand") {
     const registry = createRegistry(tools, openApiDoc.components?.schemas);