@agiflowai/one-mcp 0.2.4 → 0.2.5

package/dist/index.cjs

@@ -1,4 +1,4 @@
-const require_http = require('./http-3v8zyDO3.cjs');
+const require_http = require('./http-Q8LPwwwP.cjs');
 
 exports.HttpTransportHandler = require_http.HttpTransportHandler;
 exports.SseTransportHandler = require_http.SseTransportHandler;

package/dist/index.d.cts

@@ -1,45 +1,65 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolResult, GetPromptResult, ReadResourceResult } from "@modelcontextprotocol/sdk/types.js";
 
 //#region src/server/index.d.ts
 
+/**
+ * Configuration options for creating an MCP server instance
+ * @property configFilePath - Path to the MCP configuration file
+ * @property noCache - Skip cache when fetching remote configuration
+ * @property skills - Skills configuration with paths array (optional, skills disabled if not provided)
+ */
 interface ServerOptions {
   configFilePath?: string;
   noCache?: boolean;
+  skills?: {
+    paths: string[];
+  };
 }
 declare function createServer(options?: ServerOptions): Promise<Server>;
 //#endregion
 //#region src/types/index.d.ts
 /**
  * Tool definition for MCP
+ * @property name - The unique name of the tool
+ * @property description - Human-readable description of what the tool does
+ * @property inputSchema - JSON Schema defining the tool's input parameters
  */
 interface ToolDefinition {
   name: string;
   description: string;
   inputSchema: {
     type: string;
-    properties: Record<string, any>;
+    properties: Record<string, unknown>;
     required?: string[];
     additionalProperties?: boolean;
   };
 }
 /**
  * Base tool interface following MCP SDK patterns
+ * @template TInput - The type of input the tool accepts
  */
-interface Tool<TInput = any> {
+interface Tool<TInput = unknown> {
   getDefinition(): ToolDefinition | Promise<ToolDefinition>;
   execute(input: TInput): Promise<CallToolResult>;
 }
 /**
- * Transport mode types
+ * Transport mode constants
  */
-declare enum TransportMode {
-  STDIO = "stdio",
-  HTTP = "http",
-  SSE = "sse",
-}
+declare const TRANSPORT_MODE: {
+  readonly STDIO: "stdio";
+  readonly HTTP: "http";
+  readonly SSE: "sse";
+};
+/**
+ * Transport mode type derived from TRANSPORT_MODE constants
+ */
+type TransportMode = (typeof TRANSPORT_MODE)[keyof typeof TRANSPORT_MODE];
 /**
  * Transport configuration options
+ * @property mode - The transport mode to use (stdio, http, or sse)
+ * @property port - Port number for HTTP/SSE modes (not used for STDIO)
+ * @property host - Host address for HTTP/SSE modes (not used for STDIO)
  */
 interface TransportConfig {
   mode: TransportMode;
@@ -64,20 +84,55 @@ interface HttpTransportHandler$1 extends TransportHandler {
  * Remote MCP server configuration types
  */
 type McpServerTransportType = 'stdio' | 'http' | 'sse';
+/**
+ * Configuration for stdio-based MCP server connections
+ * @property command - The command to execute to start the server
+ * @property args - Optional arguments to pass to the command
+ * @property env - Optional environment variables for the subprocess
+ */
 interface McpStdioConfig {
   command: string;
   args?: string[];
   env?: Record<string, string>;
 }
+/**
+ * Configuration for HTTP-based MCP server connections
+ * @property url - The URL of the HTTP endpoint
+ * @property headers - Optional HTTP headers to include in requests
+ */
 interface McpHttpConfig {
   url: string;
   headers?: Record<string, string>;
 }
+/**
+ * Configuration for SSE-based MCP server connections
+ * @property url - The URL of the SSE endpoint
+ * @property headers - Optional HTTP headers to include in requests
+ */
 interface McpSseConfig {
   url: string;
   headers?: Record<string, string>;
 }
+/**
+ * Union type for MCP server transport configurations
+ * - McpStdioConfig: Used for local subprocess communication via stdio (has 'command' property)
+ * - McpHttpConfig: Used for HTTP-based remote connections (has 'url' property)
+ * - McpSseConfig: Used for Server-Sent Events streaming connections (has 'url' property)
+ *
+ * Note: McpHttpConfig and McpSseConfig have identical structure. Discrimination between
+ * them should be done using the transport type field in McpServerConfig, not by
+ * structural inspection of the config object.
+ */
 type McpServerTransportConfig = McpStdioConfig | McpHttpConfig | McpSseConfig;
+/**
+ * Configuration for an MCP server connection
+ * @property name - Unique identifier for the server
+ * @property instruction - Optional instruction text describing the server's purpose
+ * @property toolBlacklist - Optional list of tool names to exclude from this server
+ * @property omitToolDescription - Whether to omit tool descriptions in listings
+ * @property transport - The transport type (stdio, http, or sse)
+ * @property config - Transport-specific configuration options
+ */
 interface McpServerConfig {
   name: string;
   instruction?: string;
@@ -87,13 +142,67 @@ interface McpServerConfig {
   config: McpServerTransportConfig;
 }
 /**
- * Remote configuration response
+ * Skills configuration
+ * @property paths - Array of paths to skills directories
+ */
+interface SkillsConfig {
+  paths: string[];
+}
+/**
+ * Remote configuration response containing MCP server definitions
+ * @property mcpServers - Map of server names to their configurations
+ * @property skills - Optional skills configuration with paths
  */
 interface RemoteMcpConfiguration {
   mcpServers: Record<string, McpServerConfig>;
+  skills?: SkillsConfig;
+}
+/**
+ * MCP tool information returned from listTools
+ * @property name - The tool name
+ * @property description - Human-readable description
+ * @property inputSchema - JSON Schema for tool inputs
+ */
+interface McpToolInfo {
+  name: string;
+  description?: string;
+  inputSchema: Record<string, unknown>;
+}
+/**
+ * MCP resource information returned from listResources
+ * @property uri - Resource URI
+ * @property name - Display name
+ * @property description - Human-readable description
+ * @property mimeType - Optional MIME type
+ */
+interface McpResourceInfo {
+  uri: string;
+  name?: string;
+  description?: string;
+  mimeType?: string;
+}
+/**
+ * MCP prompt information returned from listPrompts
+ * @property name - Prompt name
+ * @property description - Human-readable description
+ * @property arguments - Optional argument definitions
+ */
+interface McpPromptInfo {
+  name: string;
+  description?: string;
+  arguments?: Array<{
+    name: string;
+    description?: string;
+    required?: boolean;
+  }>;
 }
 /**
- * MCP client connection interface
+ * MCP client connection interface for communicating with remote MCP servers
+ * @property serverName - The name identifier for this server connection
+ * @property serverInstruction - Optional instruction text for the server
+ * @property toolBlacklist - Optional list of tool names to exclude
+ * @property omitToolDescription - Whether to omit tool descriptions
+ * @property transport - The transport type used for this connection
  */
 interface McpClientConnection {
   serverName: string;
@@ -101,14 +210,47 @@ interface McpClientConnection {
   toolBlacklist?: string[];
   omitToolDescription?: boolean;
   transport: McpServerTransportType;
-  listTools(): Promise<any[]>;
-  listResources(): Promise<any[]>;
-  listPrompts(): Promise<any[]>;
-  callTool(name: string, args: any): Promise<any>;
-  readResource(uri: string): Promise<any>;
-  getPrompt(name: string, args?: any): Promise<any>;
+  /** List available tools from the server */
+  listTools(): Promise<McpToolInfo[]>;
+  /** List available resources from the server */
+  listResources(): Promise<McpResourceInfo[]>;
+  /** List available prompts from the server */
+  listPrompts(): Promise<McpPromptInfo[]>;
+  /** Call a tool with the given name and arguments */
+  callTool(name: string, args: Record<string, unknown>): Promise<CallToolResult>;
+  /** Read a resource by URI */
+  readResource(uri: string): Promise<ReadResourceResult>;
+  /** Get a prompt by name with optional arguments */
+  getPrompt(name: string, args?: Record<string, unknown>): Promise<GetPromptResult>;
+  /** Close the connection */
   close(): Promise<void>;
 }
+/**
+ * Skill metadata from YAML frontmatter in SKILL.md files
+ * @property name - Skill identifier used with skill__ prefix
+ * @property description - Short description shown in describe_tools
+ * @property license - Optional license information
+ */
+interface SkillMetadata {
+  name: string;
+  description: string;
+  license?: string;
+}
+/**
+ * Skill definition loaded from skill files
+ * @property name - Skill identifier used with skill__ prefix
+ * @property description - Short description shown in describe_tools
+ * @property location - Where the skill was loaded from ('project' or 'user')
+ * @property content - The markdown content of the skill (without frontmatter)
+ * @property basePath - The directory path where the skill is located
+ */
+interface Skill {
+  name: string;
+  description: string;
+  location: 'project' | 'user';
+  content: string;
+  basePath: string;
+}
 //#endregion
 //#region src/transports/stdio.d.ts
 /**
@@ -169,4 +311,4 @@ declare class HttpTransportHandler implements HttpTransportHandler$1 {
   getHost(): string;
 }
 //#endregion
-export { HttpTransportHandler, McpClientConnection, McpHttpConfig, McpServerConfig, McpServerTransportConfig, McpServerTransportType, McpSseConfig, McpStdioConfig, RemoteMcpConfiguration, type ServerOptions, SseTransportHandler, StdioTransportHandler, Tool, ToolDefinition, TransportConfig, TransportHandler, TransportMode, createServer };
+export { HttpTransportHandler, McpClientConnection, McpHttpConfig, McpPromptInfo, McpResourceInfo, McpServerConfig, McpServerTransportConfig, McpServerTransportType, McpSseConfig, McpStdioConfig, McpToolInfo, RemoteMcpConfiguration, type ServerOptions, Skill, SkillMetadata, SkillsConfig, SseTransportHandler, StdioTransportHandler, TRANSPORT_MODE, Tool, ToolDefinition, TransportConfig, TransportHandler, TransportMode, createServer };

package/dist/index.d.mts

@@ -1,45 +1,65 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolResult, GetPromptResult, ReadResourceResult } from "@modelcontextprotocol/sdk/types.js";
 
 //#region src/server/index.d.ts
 
+/**
+ * Configuration options for creating an MCP server instance
+ * @property configFilePath - Path to the MCP configuration file
+ * @property noCache - Skip cache when fetching remote configuration
+ * @property skills - Skills configuration with paths array (optional, skills disabled if not provided)
+ */
 interface ServerOptions {
   configFilePath?: string;
   noCache?: boolean;
+  skills?: {
+    paths: string[];
+  };
 }
 declare function createServer(options?: ServerOptions): Promise<Server>;
 //#endregion
 //#region src/types/index.d.ts
 /**
  * Tool definition for MCP
+ * @property name - The unique name of the tool
+ * @property description - Human-readable description of what the tool does
+ * @property inputSchema - JSON Schema defining the tool's input parameters
  */
 interface ToolDefinition {
   name: string;
   description: string;
   inputSchema: {
     type: string;
-    properties: Record<string, any>;
+    properties: Record<string, unknown>;
     required?: string[];
     additionalProperties?: boolean;
   };
 }
 /**
  * Base tool interface following MCP SDK patterns
+ * @template TInput - The type of input the tool accepts
  */
-interface Tool<TInput = any> {
+interface Tool<TInput = unknown> {
   getDefinition(): ToolDefinition | Promise<ToolDefinition>;
   execute(input: TInput): Promise<CallToolResult>;
 }
 /**
- * Transport mode types
+ * Transport mode constants
  */
-declare enum TransportMode {
-  STDIO = "stdio",
-  HTTP = "http",
-  SSE = "sse",
-}
+declare const TRANSPORT_MODE: {
+  readonly STDIO: "stdio";
+  readonly HTTP: "http";
+  readonly SSE: "sse";
+};
+/**
+ * Transport mode type derived from TRANSPORT_MODE constants
+ */
+type TransportMode = (typeof TRANSPORT_MODE)[keyof typeof TRANSPORT_MODE];
 /**
  * Transport configuration options
+ * @property mode - The transport mode to use (stdio, http, or sse)
+ * @property port - Port number for HTTP/SSE modes (not used for STDIO)
+ * @property host - Host address for HTTP/SSE modes (not used for STDIO)
  */
 interface TransportConfig {
   mode: TransportMode;
@@ -64,20 +84,55 @@ interface HttpTransportHandler$1 extends TransportHandler {
  * Remote MCP server configuration types
  */
 type McpServerTransportType = 'stdio' | 'http' | 'sse';
+/**
+ * Configuration for stdio-based MCP server connections
+ * @property command - The command to execute to start the server
+ * @property args - Optional arguments to pass to the command
+ * @property env - Optional environment variables for the subprocess
+ */
 interface McpStdioConfig {
   command: string;
   args?: string[];
   env?: Record<string, string>;
 }
+/**
+ * Configuration for HTTP-based MCP server connections
+ * @property url - The URL of the HTTP endpoint
+ * @property headers - Optional HTTP headers to include in requests
+ */
 interface McpHttpConfig {
   url: string;
   headers?: Record<string, string>;
 }
+/**
+ * Configuration for SSE-based MCP server connections
+ * @property url - The URL of the SSE endpoint
+ * @property headers - Optional HTTP headers to include in requests
+ */
 interface McpSseConfig {
   url: string;
   headers?: Record<string, string>;
 }
+/**
+ * Union type for MCP server transport configurations
+ * - McpStdioConfig: Used for local subprocess communication via stdio (has 'command' property)
+ * - McpHttpConfig: Used for HTTP-based remote connections (has 'url' property)
+ * - McpSseConfig: Used for Server-Sent Events streaming connections (has 'url' property)
+ *
+ * Note: McpHttpConfig and McpSseConfig have identical structure. Discrimination between
+ * them should be done using the transport type field in McpServerConfig, not by
+ * structural inspection of the config object.
+ */
 type McpServerTransportConfig = McpStdioConfig | McpHttpConfig | McpSseConfig;
+/**
+ * Configuration for an MCP server connection
+ * @property name - Unique identifier for the server
+ * @property instruction - Optional instruction text describing the server's purpose
+ * @property toolBlacklist - Optional list of tool names to exclude from this server
+ * @property omitToolDescription - Whether to omit tool descriptions in listings
+ * @property transport - The transport type (stdio, http, or sse)
+ * @property config - Transport-specific configuration options
+ */
 interface McpServerConfig {
   name: string;
   instruction?: string;
@@ -87,13 +142,67 @@ interface McpServerConfig {
   config: McpServerTransportConfig;
 }
 /**
- * Remote configuration response
+ * Skills configuration
+ * @property paths - Array of paths to skills directories
+ */
+interface SkillsConfig {
+  paths: string[];
+}
+/**
+ * Remote configuration response containing MCP server definitions
+ * @property mcpServers - Map of server names to their configurations
+ * @property skills - Optional skills configuration with paths
  */
 interface RemoteMcpConfiguration {
   mcpServers: Record<string, McpServerConfig>;
+  skills?: SkillsConfig;
+}
+/**
+ * MCP tool information returned from listTools
+ * @property name - The tool name
+ * @property description - Human-readable description
+ * @property inputSchema - JSON Schema for tool inputs
+ */
+interface McpToolInfo {
+  name: string;
+  description?: string;
+  inputSchema: Record<string, unknown>;
+}
+/**
+ * MCP resource information returned from listResources
+ * @property uri - Resource URI
+ * @property name - Display name
+ * @property description - Human-readable description
+ * @property mimeType - Optional MIME type
+ */
+interface McpResourceInfo {
+  uri: string;
+  name?: string;
+  description?: string;
+  mimeType?: string;
+}
+/**
+ * MCP prompt information returned from listPrompts
+ * @property name - Prompt name
+ * @property description - Human-readable description
+ * @property arguments - Optional argument definitions
+ */
+interface McpPromptInfo {
+  name: string;
+  description?: string;
+  arguments?: Array<{
+    name: string;
+    description?: string;
+    required?: boolean;
+  }>;
 }
 /**
- * MCP client connection interface
+ * MCP client connection interface for communicating with remote MCP servers
+ * @property serverName - The name identifier for this server connection
+ * @property serverInstruction - Optional instruction text for the server
+ * @property toolBlacklist - Optional list of tool names to exclude
+ * @property omitToolDescription - Whether to omit tool descriptions
+ * @property transport - The transport type used for this connection
  */
 interface McpClientConnection {
   serverName: string;
@@ -101,14 +210,47 @@ interface McpClientConnection {
   toolBlacklist?: string[];
   omitToolDescription?: boolean;
   transport: McpServerTransportType;
-  listTools(): Promise<any[]>;
-  listResources(): Promise<any[]>;
-  listPrompts(): Promise<any[]>;
-  callTool(name: string, args: any): Promise<any>;
-  readResource(uri: string): Promise<any>;
-  getPrompt(name: string, args?: any): Promise<any>;
+  /** List available tools from the server */
+  listTools(): Promise<McpToolInfo[]>;
+  /** List available resources from the server */
+  listResources(): Promise<McpResourceInfo[]>;
+  /** List available prompts from the server */
+  listPrompts(): Promise<McpPromptInfo[]>;
+  /** Call a tool with the given name and arguments */
+  callTool(name: string, args: Record<string, unknown>): Promise<CallToolResult>;
+  /** Read a resource by URI */
+  readResource(uri: string): Promise<ReadResourceResult>;
+  /** Get a prompt by name with optional arguments */
+  getPrompt(name: string, args?: Record<string, unknown>): Promise<GetPromptResult>;
+  /** Close the connection */
   close(): Promise<void>;
 }
+/**
+ * Skill metadata from YAML frontmatter in SKILL.md files
+ * @property name - Skill identifier used with skill__ prefix
+ * @property description - Short description shown in describe_tools
+ * @property license - Optional license information
+ */
+interface SkillMetadata {
+  name: string;
+  description: string;
+  license?: string;
+}
+/**
+ * Skill definition loaded from skill files
+ * @property name - Skill identifier used with skill__ prefix
+ * @property description - Short description shown in describe_tools
+ * @property location - Where the skill was loaded from ('project' or 'user')
+ * @property content - The markdown content of the skill (without frontmatter)
+ * @property basePath - The directory path where the skill is located
+ */
+interface Skill {
+  name: string;
+  description: string;
+  location: 'project' | 'user';
+  content: string;
+  basePath: string;
+}
 //#endregion
 //#region src/transports/stdio.d.ts
 /**
@@ -169,4 +311,4 @@ declare class HttpTransportHandler implements HttpTransportHandler$1 {
   getHost(): string;
 }
 //#endregion
-export { HttpTransportHandler, McpClientConnection, McpHttpConfig, McpServerConfig, McpServerTransportConfig, McpServerTransportType, McpSseConfig, McpStdioConfig, RemoteMcpConfiguration, type ServerOptions, SseTransportHandler, StdioTransportHandler, Tool, ToolDefinition, TransportConfig, TransportHandler, TransportMode, createServer };
+export { HttpTransportHandler, McpClientConnection, McpHttpConfig, McpPromptInfo, McpResourceInfo, McpServerConfig, McpServerTransportConfig, McpServerTransportType, McpSseConfig, McpStdioConfig, McpToolInfo, RemoteMcpConfiguration, type ServerOptions, Skill, SkillMetadata, SkillsConfig, SseTransportHandler, StdioTransportHandler, TRANSPORT_MODE, Tool, ToolDefinition, TransportConfig, TransportHandler, TransportMode, createServer };

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { i as createServer, n as SseTransportHandler, r as StdioTransportHandler, t as HttpTransportHandler } from "./http-CzQfsUEI.mjs";
+import { i as createServer, n as SseTransportHandler, r as StdioTransportHandler, t as HttpTransportHandler } from "./http-BKDyW8YB.mjs";
 
 export { HttpTransportHandler, SseTransportHandler, StdioTransportHandler, createServer };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agiflowai/one-mcp",
   "description": "One MCP server package",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "license": "AGPL-3.0",
   "keywords": [
     "mcp",
@@ -23,10 +23,11 @@
     "chalk": "5.6.2",
     "commander": "14.0.1",
     "express": "^4.21.2",
+    "gray-matter": "^4.0.3",
     "js-yaml": "^4.1.0",
     "liquidjs": "^10.21.0",
     "zod": "^3.24.1",
-    "@agiflowai/aicode-utils": "1.0.7"
+    "@agiflowai/aicode-utils": "1.0.8"
   },
   "devDependencies": {
     "@types/express": "^5.0.0",