@agiflowai/one-mcp 0.2.0

package/dist/index.cjs

@@ -0,0 +1,6 @@
+const require_http = require('./http-B5WVqLzz.cjs');
+
+exports.HttpTransportHandler = require_http.HttpTransportHandler;
+exports.SseTransportHandler = require_http.SseTransportHandler;
+exports.StdioTransportHandler = require_http.StdioTransportHandler;
+exports.createServer = require_http.createServer;

package/dist/index.d.cts

@@ -0,0 +1,172 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+
+//#region src/server/index.d.ts
+
+interface ServerOptions {
+  configFilePath?: string;
+  noCache?: boolean;
+}
+declare function createServer(options?: ServerOptions): Promise<Server>;
+//#endregion
+//#region src/types/index.d.ts
+/**
+ * Tool definition for MCP
+ */
+interface ToolDefinition {
+  name: string;
+  description: string;
+  inputSchema: {
+    type: string;
+    properties: Record<string, any>;
+    required?: string[];
+    additionalProperties?: boolean;
+  };
+}
+/**
+ * Base tool interface following MCP SDK patterns
+ */
+interface Tool<TInput = any> {
+  getDefinition(): ToolDefinition | Promise<ToolDefinition>;
+  execute(input: TInput): Promise<CallToolResult>;
+}
+/**
+ * Transport mode types
+ */
+declare enum TransportMode {
+  STDIO = "stdio",
+  HTTP = "http",
+  SSE = "sse",
+}
+/**
+ * Transport configuration options
+ */
+interface TransportConfig {
+  mode: TransportMode;
+  port?: number;
+  host?: string;
+}
+/**
+ * Base interface for all transport handlers
+ */
+interface TransportHandler {
+  start(): Promise<void>;
+  stop(): Promise<void>;
+}
+/**
+ * HTTP transport specific types
+ */
+interface HttpTransportHandler$1 extends TransportHandler {
+  getPort(): number;
+  getHost(): string;
+}
+/**
+ * Remote MCP server configuration types
+ */
+type McpServerTransportType = 'stdio' | 'http' | 'sse';
+interface McpStdioConfig {
+  command: string;
+  args?: string[];
+  env?: Record<string, string>;
+}
+interface McpHttpConfig {
+  url: string;
+  headers?: Record<string, string>;
+}
+interface McpSseConfig {
+  url: string;
+  headers?: Record<string, string>;
+}
+type McpServerTransportConfig = McpStdioConfig | McpHttpConfig | McpSseConfig;
+interface McpServerConfig {
+  name: string;
+  instruction?: string;
+  toolBlacklist?: string[];
+  omitToolDescription?: boolean;
+  transport: McpServerTransportType;
+  config: McpServerTransportConfig;
+}
+/**
+ * Remote configuration response
+ */
+interface RemoteMcpConfiguration {
+  mcpServers: Record<string, McpServerConfig>;
+}
+/**
+ * MCP client connection interface
+ */
+interface McpClientConnection {
+  serverName: string;
+  serverInstruction?: string;
+  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>;
+  close(): Promise<void>;
+}
+//#endregion
+//#region src/transports/stdio.d.ts
+/**
+ * Stdio transport handler for MCP server
+ * Used for command-line and direct integrations
+ */
+declare class StdioTransportHandler implements TransportHandler {
+  private server;
+  private transport;
+  constructor(server: Server);
+  start(): Promise<void>;
+  stop(): Promise<void>;
+}
+//#endregion
+//#region src/transports/sse.d.ts
+/**
+ * SSE (Server-Sent Events) transport handler
+ * Legacy transport for backwards compatibility (protocol version 2024-11-05)
+ * Uses separate endpoints: /sse for SSE stream (GET) and /messages for client messages (POST)
+ */
+declare class SseTransportHandler implements HttpTransportHandler$1 {
+  private serverFactory;
+  private app;
+  private server;
+  private sessionManager;
+  private config;
+  constructor(serverFactory: Server | (() => Server), config: TransportConfig);
+  private setupMiddleware;
+  private setupRoutes;
+  private handleSseConnection;
+  private handlePostMessage;
+  start(): Promise<void>;
+  stop(): Promise<void>;
+  getPort(): number;
+  getHost(): string;
+}
+//#endregion
+//#region src/transports/http.d.ts
+/**
+ * HTTP transport handler using Streamable HTTP (protocol version 2025-03-26)
+ * Provides stateful session management with resumability support
+ */
+declare class HttpTransportHandler implements HttpTransportHandler$1 {
+  private serverFactory;
+  private app;
+  private server;
+  private sessionManager;
+  private config;
+  constructor(serverFactory: Server | (() => Server), config: TransportConfig);
+  private setupMiddleware;
+  private setupRoutes;
+  private handlePostRequest;
+  private handleGetRequest;
+  private handleDeleteRequest;
+  start(): Promise<void>;
+  stop(): Promise<void>;
+  getPort(): number;
+  getHost(): string;
+}
+//#endregion
+export { HttpTransportHandler, McpClientConnection, McpHttpConfig, McpServerConfig, McpServerTransportConfig, McpServerTransportType, McpSseConfig, McpStdioConfig, RemoteMcpConfiguration, type ServerOptions, SseTransportHandler, StdioTransportHandler, Tool, ToolDefinition, TransportConfig, TransportHandler, TransportMode, createServer };

package/dist/index.d.mts

@@ -0,0 +1,172 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+
+//#region src/server/index.d.ts
+
+interface ServerOptions {
+  configFilePath?: string;
+  noCache?: boolean;
+}
+declare function createServer(options?: ServerOptions): Promise<Server>;
+//#endregion
+//#region src/types/index.d.ts
+/**
+ * Tool definition for MCP
+ */
+interface ToolDefinition {
+  name: string;
+  description: string;
+  inputSchema: {
+    type: string;
+    properties: Record<string, any>;
+    required?: string[];
+    additionalProperties?: boolean;
+  };
+}
+/**
+ * Base tool interface following MCP SDK patterns
+ */
+interface Tool<TInput = any> {
+  getDefinition(): ToolDefinition | Promise<ToolDefinition>;
+  execute(input: TInput): Promise<CallToolResult>;
+}
+/**
+ * Transport mode types
+ */
+declare enum TransportMode {
+  STDIO = "stdio",
+  HTTP = "http",
+  SSE = "sse",
+}
+/**
+ * Transport configuration options
+ */
+interface TransportConfig {
+  mode: TransportMode;
+  port?: number;
+  host?: string;
+}
+/**
+ * Base interface for all transport handlers
+ */
+interface TransportHandler {
+  start(): Promise<void>;
+  stop(): Promise<void>;
+}
+/**
+ * HTTP transport specific types
+ */
+interface HttpTransportHandler$1 extends TransportHandler {
+  getPort(): number;
+  getHost(): string;
+}
+/**
+ * Remote MCP server configuration types
+ */
+type McpServerTransportType = 'stdio' | 'http' | 'sse';
+interface McpStdioConfig {
+  command: string;
+  args?: string[];
+  env?: Record<string, string>;
+}
+interface McpHttpConfig {
+  url: string;
+  headers?: Record<string, string>;
+}
+interface McpSseConfig {
+  url: string;
+  headers?: Record<string, string>;
+}
+type McpServerTransportConfig = McpStdioConfig | McpHttpConfig | McpSseConfig;
+interface McpServerConfig {
+  name: string;
+  instruction?: string;
+  toolBlacklist?: string[];
+  omitToolDescription?: boolean;
+  transport: McpServerTransportType;
+  config: McpServerTransportConfig;
+}
+/**
+ * Remote configuration response
+ */
+interface RemoteMcpConfiguration {
+  mcpServers: Record<string, McpServerConfig>;
+}
+/**
+ * MCP client connection interface
+ */
+interface McpClientConnection {
+  serverName: string;
+  serverInstruction?: string;
+  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>;
+  close(): Promise<void>;
+}
+//#endregion
+//#region src/transports/stdio.d.ts
+/**
+ * Stdio transport handler for MCP server
+ * Used for command-line and direct integrations
+ */
+declare class StdioTransportHandler implements TransportHandler {
+  private server;
+  private transport;
+  constructor(server: Server);
+  start(): Promise<void>;
+  stop(): Promise<void>;
+}
+//#endregion
+//#region src/transports/sse.d.ts
+/**
+ * SSE (Server-Sent Events) transport handler
+ * Legacy transport for backwards compatibility (protocol version 2024-11-05)
+ * Uses separate endpoints: /sse for SSE stream (GET) and /messages for client messages (POST)
+ */
+declare class SseTransportHandler implements HttpTransportHandler$1 {
+  private serverFactory;
+  private app;
+  private server;
+  private sessionManager;
+  private config;
+  constructor(serverFactory: Server | (() => Server), config: TransportConfig);
+  private setupMiddleware;
+  private setupRoutes;
+  private handleSseConnection;
+  private handlePostMessage;
+  start(): Promise<void>;
+  stop(): Promise<void>;
+  getPort(): number;
+  getHost(): string;
+}
+//#endregion
+//#region src/transports/http.d.ts
+/**
+ * HTTP transport handler using Streamable HTTP (protocol version 2025-03-26)
+ * Provides stateful session management with resumability support
+ */
+declare class HttpTransportHandler implements HttpTransportHandler$1 {
+  private serverFactory;
+  private app;
+  private server;
+  private sessionManager;
+  private config;
+  constructor(serverFactory: Server | (() => Server), config: TransportConfig);
+  private setupMiddleware;
+  private setupRoutes;
+  private handlePostRequest;
+  private handleGetRequest;
+  private handleDeleteRequest;
+  start(): Promise<void>;
+  stop(): Promise<void>;
+  getPort(): number;
+  getHost(): string;
+}
+//#endregion
+export { HttpTransportHandler, McpClientConnection, McpHttpConfig, McpServerConfig, McpServerTransportConfig, McpServerTransportType, McpSseConfig, McpStdioConfig, RemoteMcpConfiguration, type ServerOptions, SseTransportHandler, StdioTransportHandler, Tool, ToolDefinition, TransportConfig, TransportHandler, TransportMode, createServer };

package/dist/index.mjs

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

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@agiflowai/one-mcp",
+  "description": "One MCP server package",
+  "version": "0.2.0",
+  "license": "AGPL-3.0",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "typescript"
+  ],
+  "bin": {
+    "one-mcp": "./dist/cli.cjs"
+  },
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.cts",
+  "module": "./dist/index.mjs",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.19.1",
+    "chalk": "5.6.2",
+    "commander": "14.0.1",
+    "express": "^4.21.2",
+    "js-yaml": "^4.1.0",
+    "zod": "^3.24.1",
+    "@agiflowai/aicode-utils": "1.0.3"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
+    "tsdown": "^0.16.4",
+    "typescript": "5.9.3",
+    "unplugin-raw": "^0.6.3",
+    "vitest": "^2.1.8"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./cli": {
+      "import": "./dist/cli.mjs",
+      "require": "./dist/cli.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "dev": "node --loader ts-node/esm src/cli.ts mcp-serve",
+    "build": "tsdown",
+    "test": "vitest --run",
+    "typecheck": "tsc --noEmit"
+  }
+}