@easbot/mcp 0.2.21

package/dist/index.d.ts

@@ -0,0 +1,408 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
+import z from 'zod';
+
+interface McpLocalConfig {
+    type: 'local';
+    command: string[];
+    environment?: Record<string, string>;
+    enabled?: boolean;
+    timeout?: number;
+}
+interface McpOAuthConfig {
+    clientId?: string;
+    clientSecret?: string;
+    scope?: string;
+}
+interface McpRemoteConfig {
+    type: 'remote';
+    url: string;
+    enabled?: boolean;
+    headers?: Record<string, string>;
+    oauth?: McpOAuthConfig | false;
+    timeout?: number;
+}
+type McpConfig = McpLocalConfig | McpRemoteConfig;
+declare const ServerTransportType: {
+    readonly STDIO: "stdio";
+    readonly HTTP: "http";
+};
+type ServerTransportType = (typeof ServerTransportType)[keyof typeof ServerTransportType];
+declare const ServerStatus: {
+    readonly STOPPED: "stopped";
+    readonly STARTING: "starting";
+    readonly RUNNING: "running";
+    readonly STOPPING: "stopping";
+    readonly ERROR: "error";
+};
+type ServerStatus = (typeof ServerStatus)[keyof typeof ServerStatus];
+interface ServerInfo {
+    id: string;
+    name: string;
+    version: string;
+    transportType: ServerTransportType;
+    status: ServerStatus;
+    createdAt: number;
+    lastActivityAt: number;
+    enabled?: boolean;
+}
+interface StdioServerConfig {
+    id: string;
+    name: string;
+    version: string;
+    transportType: typeof ServerTransportType.STDIO;
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    enabled?: boolean;
+    timeout?: number;
+}
+interface HttpServerConfig {
+    id: string;
+    name: string;
+    version: string;
+    transportType: typeof ServerTransportType.HTTP;
+    url: string;
+    headers?: Record<string, string>;
+    enabled?: boolean;
+    timeout?: number;
+}
+interface ServerInstance$2 {
+    info: ServerInfo;
+    get server(): McpServer | null;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    restart(): Promise<void>;
+}
+
+interface ServerInstance$1 {
+    info: ServerInfo;
+    get server(): McpServer | null;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    restart(): Promise<void>;
+}
+declare class StdioServerAdapter {
+    private config;
+    private server;
+    private info;
+    private isStarting;
+    private isStopping;
+    private toolEventCleanup;
+    constructor(config: StdioServerConfig);
+    getInfo(): ServerInfo;
+    getConfig(): StdioServerConfig;
+    createInstance(): ServerInstance$1;
+    private loadTools;
+    private subscribeToolEvents;
+    private handleToolRegistered;
+    private adaptToolHandler;
+    private unsubscribeToolEvents;
+    private convertToZodSchema;
+    private jsonSchemaToZod;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    restart(): Promise<void>;
+}
+declare function createStdioServer(config: StdioServerConfig): StdioServerAdapter;
+declare function createAndStartStdioServer(config: StdioServerConfig): Promise<ServerInstance$1>;
+
+interface ServerInstance {
+    info: ServerInfo;
+    get server(): McpServer | null;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    restart(): Promise<void>;
+}
+declare class HttpServerAdapter {
+    private config;
+    private server;
+    private transport;
+    private httpServer;
+    private info;
+    private isStarting;
+    private isStopping;
+    private toolCleanup;
+    constructor(config: HttpServerConfig);
+    getInfo(): ServerInfo;
+    getConfig(): HttpServerConfig;
+    createInstance(): ServerInstance;
+    private loadTools;
+    private subscribeTools;
+    private handleTool;
+    private convertToZodSchema;
+    private jsonSchemaToZod;
+    private adaptToolHandler;
+    private unsubscribeTools;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    restart(): Promise<void>;
+}
+declare function createHttpServer(config: HttpServerConfig): HttpServerAdapter;
+declare function createAndStartHttpServer(config: HttpServerConfig): Promise<ServerInstance>;
+
+interface OAuthConfig {
+    clientId?: string;
+    clientSecret?: string;
+    scope?: string;
+    metadataUrl?: string;
+}
+interface LocalMCPConfig {
+    type: 'local';
+    command: string[];
+    environment?: Record<string, string>;
+    timeout?: number;
+}
+interface RemoteMCPConfig {
+    type: 'remote';
+    url: string;
+    headers?: Record<string, string>;
+    transport?: 'streamable-http' | 'sse';
+    oauth?: OAuthConfig | false;
+    timeout?: number;
+}
+type MCPConfig = LocalMCPConfig | RemoteMCPConfig;
+declare const Status: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"connected">;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"disconnected">;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"failed">;
+    error: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"needs_auth">;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"needs_client_registration">;
+    error: z.ZodString;
+}, z.core.$strip>], "status">;
+type Status = z.infer<typeof Status>;
+interface ToolMetadata {
+    name: string;
+    description?: string;
+    inputSchema: unknown;
+}
+interface ResourceMetadata {
+    name: string;
+    uri: string;
+    description?: string;
+    mimeType?: string;
+}
+interface PromptMetadata {
+    name: string;
+    description?: string;
+    arguments?: Array<{
+        name: string;
+        description?: string;
+        required?: boolean;
+    }>;
+}
+interface ClientInfo {
+    id: string;
+    name: string;
+    status: Status;
+    connectedAt?: number;
+    serverVersion?: string;
+    protocolVersion?: string;
+    tools: ToolMetadata[];
+    resources: ResourceMetadata[];
+    prompts: PromptMetadata[];
+    error?: string;
+}
+interface ToolCallResult {
+    toolName: string;
+    args: Record<string, unknown>;
+    result: unknown;
+    success: boolean;
+    error?: string;
+    duration: number;
+}
+interface AuthResult {
+    authorizationUrl: string;
+    state?: string;
+}
+declare class MCPClient {
+    private id;
+    private client;
+    private _info;
+    private notificationCleanup;
+    private pendingTransport;
+    private oauthState;
+    private toolListChangedHandler;
+    constructor();
+    get info(): ClientInfo;
+    get status(): Status;
+    get tools(): ToolMetadata[];
+    connect(id: string, config: MCPConfig): Promise<void>;
+    startAuth(): Promise<AuthResult>;
+    finishAuth(authorizationCode?: string): Promise<void>;
+    disconnect(): Promise<void>;
+    listTools(): Promise<Record<string, unknown>>;
+    callTool(toolName: string, args: Record<string, unknown>, timeout?: number): Promise<ToolCallResult>;
+    listResources(): Promise<ResourceMetadata[]>;
+    readResource(uri: string): Promise<{
+        [x: string]: unknown;
+        contents: ({
+            uri: string;
+            text: string;
+            mimeType?: string | undefined;
+            _meta?: Record<string, unknown> | undefined;
+        } | {
+            uri: string;
+            blob: string;
+            mimeType?: string | undefined;
+            _meta?: Record<string, unknown> | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined>;
+    listPrompts(): Promise<PromptMetadata[]>;
+    getPrompt(name: string, args?: Record<string, string>): Promise<{
+        [x: string]: unknown;
+        messages: {
+            role: "user" | "assistant";
+            content: {
+                type: "text";
+                text: string;
+                annotations?: {
+                    audience?: ("user" | "assistant")[] | undefined;
+                    priority?: number | undefined;
+                    lastModified?: string | undefined;
+                } | undefined;
+                _meta?: Record<string, unknown> | undefined;
+            } | {
+                type: "image";
+                data: string;
+                mimeType: string;
+                annotations?: {
+                    audience?: ("user" | "assistant")[] | undefined;
+                    priority?: number | undefined;
+                    lastModified?: string | undefined;
+                } | undefined;
+                _meta?: Record<string, unknown> | undefined;
+            } | {
+                type: "audio";
+                data: string;
+                mimeType: string;
+                annotations?: {
+                    audience?: ("user" | "assistant")[] | undefined;
+                    priority?: number | undefined;
+                    lastModified?: string | undefined;
+                } | undefined;
+                _meta?: Record<string, unknown> | undefined;
+            } | {
+                type: "resource";
+                resource: {
+                    uri: string;
+                    text: string;
+                    mimeType?: string | undefined;
+                    _meta?: Record<string, unknown> | undefined;
+                } | {
+                    uri: string;
+                    blob: string;
+                    mimeType?: string | undefined;
+                    _meta?: Record<string, unknown> | undefined;
+                };
+                annotations?: {
+                    audience?: ("user" | "assistant")[] | undefined;
+                    priority?: number | undefined;
+                    lastModified?: string | undefined;
+                } | undefined;
+                _meta?: Record<string, unknown> | undefined;
+            } | {
+                uri: string;
+                name: string;
+                type: "resource_link";
+                description?: string | undefined;
+                mimeType?: string | undefined;
+                size?: number | undefined;
+                annotations?: {
+                    audience?: ("user" | "assistant")[] | undefined;
+                    priority?: number | undefined;
+                    lastModified?: string | undefined;
+                } | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                icons?: {
+                    src: string;
+                    mimeType?: string | undefined;
+                    sizes?: string[] | undefined;
+                    theme?: "light" | "dark" | undefined;
+                }[] | undefined;
+                title?: string | undefined;
+            };
+        }[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        description?: string | undefined;
+    } | undefined>;
+    refreshTools(): Promise<void>;
+    private createClient;
+    private fetchCapabilities;
+    private createLocalClient;
+    private createRemoteClient;
+    private connectWithTransport;
+    registerToolListChangedHandler(handler: () => void | Promise<void>): void;
+    private registerNotificationHandler;
+    private createInitialInfo;
+}
+declare function createMCPClient(): MCPClient;
+
+declare namespace Log {
+    const Level: z.ZodEnum<{
+        DEBUG: "DEBUG";
+        INFO: "INFO";
+        WARN: "WARN";
+        ERROR: "ERROR";
+    }>;
+    type Level = z.infer<typeof Level>;
+    function getLevel(): Level;
+    type Logger = {
+        debug(message?: any, extra?: Record<string, any>): void;
+        info(message?: any, extra?: Record<string, any>): void;
+        error(message?: any, extra?: Record<string, any>): void;
+        warn(message?: any, extra?: Record<string, any>): void;
+        tag(key: string, value: string): Logger;
+        clone(): Logger;
+        time(message: string, extra?: Record<string, any>): {
+            stop(): void;
+            [Symbol.dispose](): void;
+        };
+    };
+    const Default: Logger;
+    interface Options {
+        print: boolean;
+        logDir: string;
+        logFile?: string;
+        dev?: boolean;
+        level?: Level;
+    }
+    function file(): string;
+    function init(options: Options): Promise<void>;
+    function close(): Promise<void>;
+    function create(tags?: Record<string, any>): Logger;
+}
+
+declare function getVersion(): string;
+
+declare const VERSION = "0.2.20";
+declare const NAME = "@easbot/mcp";
+declare function initLog(options: {
+    print: boolean;
+    logDir?: string;
+    logFile?: string;
+    dev?: boolean;
+    level?: 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
+}): Promise<void>;
+
+export { type AuthResult, type ClientInfo, HttpServerAdapter, type HttpServerConfig, type LocalMCPConfig, Log, MCPClient, type MCPConfig, type McpConfig, type McpLocalConfig, type McpOAuthConfig, type McpRemoteConfig, NAME, type OAuthConfig, type PromptMetadata, type RemoteMCPConfig, type ResourceMetadata, type ServerInfo, type ServerInstance$2 as ServerInstance, ServerStatus, ServerTransportType, Status, StdioServerAdapter, type StdioServerConfig, type ToolCallResult, type ToolMetadata, VERSION, createAndStartHttpServer, createAndStartStdioServer, createHttpServer, createMCPClient, createStdioServer, getVersion, initLog };

package/dist/index.mjs

@@ -0,0 +1,3 @@
+import {b,a}from'./chunks/chunk-PJM3ON7Z.mjs';export{b as Log}from'./chunks/chunk-PJM3ON7Z.mjs';import {McpServer}from'@modelcontextprotocol/sdk/server/mcp';import {StdioServerTransport}from'@modelcontextprotocol/sdk/server/stdio';import {EventEmitter}from'events';import l from'zod/v4';import q from'http';import {StreamableHTTPServerTransport}from'@modelcontextprotocol/sdk/server/streamableHttp';import {Client}from'@modelcontextprotocol/sdk/client/index.js';import {StdioClientTransport}from'@modelcontextprotocol/sdk/client/stdio.js';import {StreamableHTTPClientTransport}from'@modelcontextprotocol/sdk/client/streamableHttp.js';import {SSEClientTransport}from'@modelcontextprotocol/sdk/client/sse.js';import {CallToolResultSchema,ToolListChangedNotificationSchema}from'@modelcontextprotocol/sdk/types.js';import {UnauthorizedError}from'@modelcontextprotocol/sdk/client/auth.js';import {withTimeout}from'@easbot/utils';import v from'zod';var N={STDIO:"stdio",HTTP:"http"},c={STOPPED:"stopped",STARTING:"starting",RUNNING:"running",STOPPING:"stopping",ERROR:"error"};var _=b.create({service:"tool-registry"}),T={REGISTERED:"mcp.tool.registered",UNREGISTERED:"mcp.tool.unregistered",CLEARED:"mcp.tool.cleared"},k=class extends EventEmitter{constructor(){super();a(this,"tools",new Map);}register(e){if(!e.name||typeof e.name!="string")throw new Error("\u5DE5\u5177\u540D\u79F0\u65E0\u6548\uFF1A\u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32");if(this.tools.has(e.name)){_?.debug("tool already registered, skipping",{tool:e.name});return}this.tools.set(e.name,e),this.emit(T.REGISTERED,e);}unregister(e){return this.tools.has(e)?(this.tools.delete(e),this.emit(T.UNREGISTERED,e),true):false}get(e){return this.tools.get(e)}getAll(){return Array.from(this.tools.values())}getTools(){return Array.from(this.tools.values()).map(({handler:e,...r})=>r)}has(e){return this.tools.has(e)}getSize(){return this.tools.size}clear(){this.tools.clear(),this.emit(T.CLEARED);}},y=new k;var g=b.create({service:"mcp.server.stdio"}),E=class{constructor(t){a(this,"config");a(this,"server",null);a(this,"info");a(this,"isStarting",false);a(this,"isStopping",false);a(this,"toolEventCleanup",null);a(this,"handleToolRegistered",t=>{if(this.server){let e=this.convertToZodSchema(t.inputSchema),r=this.adaptToolHandler(t.handler);this.server.registerTool(t.name,{description:t.description,inputSchema:e},r),g.info("tool registered",{tool:t.name});}});this.config=t,this.info={id:t.id,name:t.name,version:t.version,transportType:t.transportType,status:c.STOPPED,createdAt:Date.now(),lastActivityAt:Date.now(),enabled:t.enabled};}getInfo(){return this.info}getConfig(){return this.config}createInstance(){let t=this;return {info:this.info,get server(){return t.server},start:()=>this.start(),stop:()=>this.stop(),restart:()=>this.restart()}}loadTools(){if(this.server)for(let t of y.getAll()){let e=this.convertToZodSchema(t.inputSchema),r=this.adaptToolHandler(t.handler);this.server.registerTool(t.name,{description:t.description,inputSchema:e},r),g.info("tool loaded",{tool:t.name});}}subscribeToolEvents(){this.toolEventCleanup=()=>{y.off(T.REGISTERED,this.handleToolRegistered);},y.on(T.REGISTERED,this.handleToolRegistered);}adaptToolHandler(t){return async(e,r)=>{let o={signal:r.signal,sessionId:r.sessionId,requestId:r.requestId,taskId:r.taskId,_meta:r._meta,authInfo:r.authInfo?{type:"bearer",claims:{clientId:r.authInfo.clientId,scopes:r.authInfo.scopes}}:void 0};return t(e,o)}}unsubscribeToolEvents(){this.toolEventCleanup&&(this.toolEventCleanup(),this.toolEventCleanup=null);}convertToZodSchema(t){if(t instanceof l.ZodType)return t;if(typeof t=="object"&&t!==null){let e=t;if(e.type==="object"){let r=e.properties||{},o=e.required||[],n={};for(let[i,f]of Object.entries(r))n[i]=this.jsonSchemaToZod(f);if(Object.keys(r).filter(i=>!o.includes(i)).length===0)return l.object(n);let u={};for(let[i,f]of Object.entries(r)){let a=n[i];a&&(o.includes(i)?u[i]=a:u[i]=a.optional());}return l.object(u)}if(e.type==="string")return l.string();if(e.type==="number")return l.number();if(e.type==="boolean")return l.boolean();if(e.type==="array"){let r=e.items;return r?l.array(this.jsonSchemaToZod(r)):l.array(l.unknown())}}return l.unknown()}jsonSchemaToZod(t){switch(t.type){case "string":return l.string();case "number":return l.number();case "integer":return l.number().int();case "boolean":return l.boolean();case "null":return l.null();case "array":{let r=t.items;return r?l.array(this.jsonSchemaToZod(r)):l.array(l.unknown())}case "object":{let r=t.properties||{},o=t.required||[],n={};for(let[i,f]of Object.entries(r))n[i]=this.jsonSchemaToZod(f);if(Object.keys(r).filter(i=>!o.includes(i)).length===0)return l.object(n);let u={};for(let[i,f]of Object.entries(r)){let a=n[i];a&&(o.includes(i)?u[i]=a:u[i]=a.optional());}return l.object(u)}default:return l.unknown()}}async start(){if(this.isStarting){g.warn("server is already starting",{id:this.info.id});return}if(this.info.status===c.RUNNING){g.debug("server is already running",{id:this.info.id});return}this.isStarting=true,this.info.status=c.STARTING;try{g.info("starting stdio mcp server",{id:this.info.id,name:this.info.name,command:this.config.command,args:this.config.args});let t=new StdioServerTransport;await t.start(),this.server=new McpServer({name:this.config.name,version:this.config.version}),this.loadTools(),this.subscribeToolEvents(),await this.server.connect(t),this.info.status=c.RUNNING,this.info.lastActivityAt=Date.now(),g.info("stdio mcp server started successfully",{id:this.info.id,name:this.info.name,toolCount:y.getSize()});}catch(t){throw this.info.status=c.ERROR,g.error("failed to start stdio mcp server",{id:this.info.id,error:t instanceof Error?t.message:String(t)}),t}finally{this.isStarting=false;}}async stop(){if(this.isStopping){g.warn("server is already stopping",{id:this.info.id});return}if(this.info.status!==c.RUNNING&&this.info.status!==c.ERROR){g.debug("server is not running",{id:this.info.id,status:this.info.status});return}this.isStopping=true,this.info.status=c.STOPPING;try{g.info("stopping stdio mcp server",{id:this.info.id,name:this.info.name}),this.unsubscribeToolEvents(),this.server&&(await this.server.close(),this.server=null),this.info.status=c.STOPPED,g.info("stdio mcp server stopped",{id:this.info.id,name:this.info.name});}catch(t){this.info.status=c.ERROR,g.error("error stopping stdio mcp server",{id:this.info.id,error:t instanceof Error?t.message:String(t)});}finally{this.isStopping=false;}}async restart(){g.info("restarting stdio mcp server",{id:this.info.id}),await this.stop(),await this.start();}};function Z(m){return new E(m)}async function z(m){let t=new E(m);return await t.start(),t.createInstance()}var h=b.create({service:"mcp.server.http"}),I=class{constructor(t){a(this,"config");a(this,"server",null);a(this,"transport",null);a(this,"httpServer",null);a(this,"info");a(this,"isStarting",false);a(this,"isStopping",false);a(this,"toolCleanup",null);a(this,"handleTool",t=>{if(this.server){let e=this.convertToZodSchema(t.inputSchema),r=this.adaptToolHandler(t.handler);this.server.registerTool(t.name,{description:t.description,inputSchema:e},r),h.info("tool registered",{tool:t.name});}});this.config=t,this.info={id:t.id,name:t.name,version:t.version,transportType:t.transportType,status:c.STOPPED,createdAt:Date.now(),lastActivityAt:Date.now()};}getInfo(){return this.info}getConfig(){return this.config}createInstance(){let t=this;return {info:this.info,get server(){return t.server},start:()=>this.start(),stop:()=>this.stop(),restart:()=>this.restart()}}loadTools(){if(this.server)for(let t of y.getAll()){let e=this.convertToZodSchema(t.inputSchema),r=this.adaptToolHandler(t.handler);this.server.registerTool(t.name,{description:t.description,inputSchema:e},r),h.info("tool loaded",{tool:t.name});}}subscribeTools(){this.toolCleanup=()=>{y.off(T.REGISTERED,this.handleTool);},y.on(T.REGISTERED,this.handleTool);}convertToZodSchema(t){if(t instanceof l.ZodType)return t;if(typeof t=="object"&&t!==null){let e=t;if(e.type==="object"){let r=e.properties||{},o=e.required||[],n={};for(let[i,f]of Object.entries(r))n[i]=this.jsonSchemaToZod(f);if(Object.keys(r).filter(i=>!o.includes(i)).length===0)return l.object(n);let u={};for(let[i,f]of Object.entries(r)){let a=n[i];a&&(o.includes(i)?u[i]=a:u[i]=a.optional());}return l.object(u)}if(e.type==="string")return l.string();if(e.type==="number")return l.number();if(e.type==="boolean")return l.boolean();if(e.type==="array"){let r=e.items;return r?l.array(this.jsonSchemaToZod(r)):l.array(l.unknown())}}return l.unknown()}jsonSchemaToZod(t){switch(t.type){case "string":return l.string();case "number":return l.number();case "integer":return l.number().int();case "boolean":return l.boolean();case "null":return l.null();case "array":{let r=t.items;return r?l.array(this.jsonSchemaToZod(r)):l.array(l.unknown())}case "object":{let r=t.properties||{},o=t.required||[],n={};for(let[i,f]of Object.entries(r))n[i]=this.jsonSchemaToZod(f);if(Object.keys(r).filter(i=>!o.includes(i)).length===0)return l.object(n);let u={};for(let[i,f]of Object.entries(r)){let a=n[i];a&&(o.includes(i)?u[i]=a:u[i]=a.optional());}return l.object(u)}default:return l.unknown()}}adaptToolHandler(t){return async(e,r)=>{let o={signal:r.signal,sessionId:r.sessionId,requestId:r.requestId,taskId:r.taskId,_meta:r._meta,authInfo:r.authInfo?{type:"bearer",claims:{clientId:r.authInfo.clientId,scopes:r.authInfo.scopes}}:void 0};return t(e,o)}}unsubscribeTools(){this.toolCleanup&&(this.toolCleanup(),this.toolCleanup=null);}async start(){if(this.isStarting){h.warn("already starting",{id:this.info.id});return}if(this.info.status===c.RUNNING){h.debug("already running",{id:this.info.id});return}this.isStarting=true,this.info.status=c.STARTING;try{h.info("starting",{id:this.info.id,name:this.info.name,url:this.config.url});let t;try{t=new URL(this.config.url);}catch{throw new Error(`\u65E0\u6548\u7684 URL: ${this.config.url}`)}let e=parseInt(t.port||"3000",10),r=t.hostname||"0.0.0.0";if(Number.isNaN(e)||e<1||e>65535)throw new Error(`\u65E0\u6548\u7684\u7AEF\u53E3\u53F7: ${t.port}`);this.transport=new StreamableHTTPServerTransport({sessionIdGenerator:()=>crypto.randomUUID()}),this.server=new McpServer({name:this.config.name,version:this.config.version}),this.loadTools(),this.subscribeTools(),await this.server.connect(this.transport),this.httpServer=q.createServer((o,n)=>{let b=o.headers.origin,u=(f,a,M)=>{n.writeHead(f,a),M?n.end(M):n.end();},i={"Access-Control-Allow-Origin":b||"*","Access-Control-Allow-Methods":"GET, POST, OPTIONS","Access-Control-Allow-Headers":"Content-Type, mcpsessionid, mcp-protocol-version","Access-Control-Max-Age":"86400"};if(o.method==="OPTIONS"){u(204,i);return}if(o.method==="POST"){let f="";o.setEncoding("utf8"),o.on("data",a=>{f+=a;}),o.on("end",()=>{let a;if(f)try{a=JSON.parse(f);}catch{a=void 0;}this.transport&&this.transport.handleRequest(o,n,a);}),o.on("error",a=>{h.error("HTTP request error",{error:a.message}),u(500,i,JSON.stringify({jsonrpc:"2.0",error:{code:-32603,message:"Internal error"}}));});}else o.method==="GET"?this.transport&&this.transport.handleRequest(o,n,void 0):u(405,i,JSON.stringify({jsonrpc:"2.0",error:{code:-32601,message:"Method not found"}}));}),this.httpServer.on("error",o=>{h.error("HTTP server error",{error:o.message}),this.info.status=c.ERROR;}),this.httpServer.on("clientError",(o,n)=>{h.warn("HTTP client error",{error:o.message}),n.writable&&n.end(`HTTP/1.1 400 Bad Request\r
+\r
+`);}),this.httpServer.listen(e,r),h.info("HTTP server listening",{hostname:r,port:e}),this.info.status=c.RUNNING,this.info.lastActivityAt=Date.now(),h.info("started",{id:this.info.id,name:this.info.name,toolCount:y.getSize()});}catch(t){throw this.info.status=c.ERROR,h.error("failed to start",{id:this.info.id,error:t instanceof Error?t.message:String(t)}),t}finally{this.isStarting=false;}}async stop(){if(this.isStopping){h.warn("already stopping",{id:this.info.id});return}if(this.info.status!==c.RUNNING&&this.info.status!==c.ERROR){h.debug("not running",{id:this.info.id,status:this.info.status});return}this.isStopping=true,this.info.status=c.STOPPING;try{h.info("stopping",{id:this.info.id,name:this.info.name}),this.unsubscribeTools(),this.httpServer&&(await new Promise(t=>{this.httpServer.close(()=>t());}),this.httpServer=null),this.transport&&(await this.transport.close(),this.transport=null),this.server&&(await this.server.close(),this.server=null),this.info.status=c.STOPPED,h.info("stopped",{id:this.info.id});}catch(t){this.info.status=c.ERROR,h.error("failed to stop",{id:this.info.id,error:t instanceof Error?t.message:String(t)});}finally{this.isStopping=false;}}async restart(){h.info("restarting",{id:this.info.id}),await this.stop(),await this.start();}};function V(m){return new I(m)}async function B(m){let t=new I(m);return await t.start(),t.createInstance()}var O={version:"0.2.21"};function x(){return O.version}var d=b.create({service:"mcp.client"}),P=3e4,Bt=v.discriminatedUnion("status",[v.object({status:v.literal("connected")}).meta({ref:"MCPStatusConnected"}),v.object({status:v.literal("disconnected")}).meta({ref:"MCPStatusDisconnected"}),v.object({status:v.literal("failed"),error:v.string()}).meta({ref:"MCPStatusFailed"}),v.object({status:v.literal("needs_auth")}).meta({ref:"MCPStatusNeedsAuth"}),v.object({status:v.literal("needs_client_registration"),error:v.string()}).meta({ref:"MCPStatusNeedsClientRegistration"})]),A=class{constructor(){a(this,"id","");a(this,"client",null);a(this,"_info");a(this,"notificationCleanup",null);a(this,"pendingTransport",null);a(this,"oauthState","");a(this,"toolListChangedHandler",null);this._info=this.createInitialInfo();}get info(){return {...this._info}}get status(){return this._info.status}get tools(){return [...this._info.tools]}async connect(t,e){d.info("connecting to MCP server",{id:t,type:e.type}),await this.disconnect(),this.id=t,this._info=this.createInitialInfo(),this._info.id=t,this._info.name=t;try{if(this.client=await this.createClient(e),!this.client)return;this._info.status={status:"connected"},this._info.connectedAt=Date.now(),await this.fetchCapabilities(),d.info("connected to MCP server",{id:t,toolCount:this._info.tools.length});}catch(r){let o=r instanceof Error?r.message:String(r);this._info.status={status:"failed",error:o},this._info.error=o,d.error("failed to connect to MCP server",{id:t,error:o});}}async startAuth(){if(!this.pendingTransport)throw new Error("No pending OAuth flow. Please connect to a server that requires authentication first.");return this.oauthState=Array.from(crypto.getRandomValues(new Uint8Array(32))).map(t=>t.toString(16).padStart(2,"0")).join(""),{authorizationUrl:"",state:this.oauthState}}async finishAuth(t){if(!this.pendingTransport)throw new Error("No pending OAuth flow.");t&&await this.pendingTransport.finishAuth?.(t),this.pendingTransport=null,d.info("OAuth completed, reconnecting...",{id:this.id});}async disconnect(){this.notificationCleanup&&(this.notificationCleanup(),this.notificationCleanup=null),this.client&&(await this.client.close().catch(t=>{d.error("Failed to close MCP client",{error:t});}),this.client=null),this.pendingTransport=null,this.toolListChangedHandler=null,this._info.status.status==="connected"&&(this._info.status={status:"disconnected"}),d.info("disconnected from MCP server",{id:this.id});}async listTools(){if(!this.client||this._info.status.status!=="connected")return {};let t={};for(let e of this._info.tools)t[e.name]={name:e.name,description:e.description,inputSchema:e.inputSchema};return t}async callTool(t,e,r){let o=Date.now();if(!this.client||this._info.status.status!=="connected")return {toolName:t,args:e,result:null,success:false,error:"Client not connected",duration:Date.now()-o};try{let n=await withTimeout(this.client.callTool({name:t,arguments:e},CallToolResultSchema,{resetTimeoutOnProgress:!0,timeout:r}),r??P);return {toolName:t,args:e,result:n.content,success:!0,duration:Date.now()-o}}catch(n){return {toolName:t,args:e,result:null,success:false,error:n instanceof Error?n.message:String(n),duration:Date.now()-o}}}async listResources(){return [...this._info.resources]}async readResource(t){if(!this.client||this._info.status.status!=="connected"){d.warn("client not connected for readResource");return}return this.client.readResource({uri:t}).catch(e=>{d.error("failed to read resource",{uri:t,error:e.message});})}async listPrompts(){return [...this._info.prompts]}async getPrompt(t,e){if(!this.client||this._info.status.status!=="connected"){d.warn("client not connected for getPrompt");return}return this.client.getPrompt({name:t,arguments:e}).catch(r=>{d.error("failed to get prompt",{name:t,error:r.message});})}async refreshTools(){if(!(!this.client||this._info.status.status!=="connected"))try{let t=await withTimeout(this.client.listTools(),P);this._info.tools=t.tools.map(e=>({name:e.name,description:e.description,inputSchema:e.inputSchema})),d.info("tools refreshed",{id:this.id,count:this._info.tools.length});}catch(t){d.error("failed to refresh tools",{id:this.id,error:t instanceof Error?t.message:String(t)});}}async createClient(t){return t.type==="local"?this.createLocalClient(t):t.type==="remote"?this.createRemoteClient(t):null}async fetchCapabilities(){if(this.client){try{let t=await withTimeout(this.client.listTools(),P);this._info.tools=t.tools.map(e=>({name:e.name,description:e.description,inputSchema:e.inputSchema}));}catch(t){d.debug("failed to get tools",{id:this.id,error:t instanceof Error?t.message:String(t)});}try{let t=await withTimeout(this.client.listResources(),5e3);this._info.resources=t.resources.map(e=>({name:e.name,uri:e.uri,description:e.description,mimeType:e.mimeType}));}catch{d.debug("failed to get resources",{id:this.id});}try{let t=await withTimeout(this.client.listPrompts(),5e3);this._info.prompts=t.prompts.map(e=>({name:e.name,description:e.description,arguments:e.arguments?.map(r=>({name:r.name,description:r.description,required:r.required}))}));}catch{d.debug("failed to get prompts",{id:this.id});}}}async createLocalClient(t){let[e,...r]=t.command;if(!e)return this._info.status={status:"failed",error:"Command is empty"},null;let o=new StdioClientTransport({stderr:"pipe",command:e,args:r.length>0?r:void 0,cwd:process.cwd(),env:Object.fromEntries(Object.entries({...process.env,...t.environment}).filter(([,n])=>n!==void 0))});o.stderr?.on("data",n=>{d.info(`mcp stderr: ${n.toString()}`,{id:this.id});});try{let n=new Client({name:"easbot-mcp",version:x()});return await withTimeout(n.connect(o),t.timeout??P),this.registerNotificationHandler(n),n}catch(n){let b=n instanceof Error?n.message:String(n);return this._info.status={status:"failed",error:b},d.error("local mcp startup failed",{command:[e,...r],error:b}),null}}async createRemoteClient(t){t.oauth===false;let r={headers:t.headers};if((t.transport||"streamable-http")==="sse"){d.info("using SSE transport",{url:t.url});let n=new SSEClientTransport(new URL(t.url),{requestInit:r});return this.connectWithTransport(n,t)}else {d.info("using StreamableHTTP transport",{url:t.url});let n=new StreamableHTTPClientTransport(new URL(t.url),{requestInit:r});return this.connectWithTransport(n,t)}}async connectWithTransport(t,e){try{let r=new Client({name:"easbot-mcp",version:x()});return await withTimeout(r.connect(t),e.timeout??P),this.registerNotificationHandler(r),r}catch(r){if(r instanceof UnauthorizedError){let o=r instanceof Error?r.message:String(r);o.includes("registration")||o.includes("client_id")?this._info.status={status:"needs_client_registration",error:"Server does not support dynamic client registration. Please provide clientId in config."}:(this._info.status={status:"needs_auth"},this.pendingTransport=t);}else {let o=r instanceof Error?r.message:String(r);this._info.status={status:"failed",error:o};}return d.error("remote mcp connection failed",{url:e.url,error:this._info.status}),null}}registerToolListChangedHandler(t){this.toolListChangedHandler=t;}registerNotificationHandler(t){let e=async()=>{d.info("tools list changed notification received",{id:this.id}),await this.refreshTools(),this.toolListChangedHandler&&await this.toolListChangedHandler();};t.setNotificationHandler(ToolListChangedNotificationSchema,e),this.notificationCleanup=()=>{t.removeNotificationHandler("notifications/tools/list_changed");};}createInitialInfo(){return {id:"",name:"",status:{status:"disconnected"},tools:[],resources:[],prompts:[]}}};function Kt(){return new A}var $t="0.2.20",Qt="@easbot/mcp";async function Xt(m){let{Log:t}=await import('./chunks/log-2GAL6FAC.mjs'),e=false;await t.init({logDir:m.logDir??process.env.EASBOT_LOG_PATH??process.cwd(),print:m.print??false,dev:m.dev??e,level:m.level??("INFO")});}export{I as HttpServerAdapter,A as MCPClient,Qt as NAME,c as ServerStatus,N as ServerTransportType,Bt as Status,E as StdioServerAdapter,$t as VERSION,B as createAndStartHttpServer,z as createAndStartStdioServer,V as createHttpServer,Kt as createMCPClient,Z as createStdioServer,x as getVersion,Xt as initLog};

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@easbot/mcp",
+  "version": "0.2.21",
+  "description": "MCP (Model Context Protocol) integration library for EASBOT ecosystem",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "mcp",
+    "protocol",
+    "library",
+    "typescript",
+    "integration"
+  ],
+  "author": "houjallen",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/houjallen/easbot.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://github.com/houjallen/easbot/tree/main/packages/mcp#readme",
+  "bugs": {
+    "url": "https://github.com/houjallen/easbot/issues"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README.en.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "ai": "^6.0.176",
+    "zod": "^4.4.3",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@easbot/types": "0.2.21",
+    "@easbot/utils": "0.2.21"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.14",
+    "@types/node": "^25.6.2",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
+  },
+  "engines": {
+    "node": ">=22.22.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "tsup --watch --env.NODE_ENV development",
+    "build": "tsup --env.NODE_ENV production",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "lint:report": "biome check --reporter=summary .",
+    "format": "biome format .",
+    "format:fix": "biome format --write .",
+    "type-check": "tsc --noEmit",
+    "clean": "npx rimraf dist node_modules",
+    "publish:npm": "bash scripts/publish.sh",
+    "publish:npm:win": "powershell -ExecutionPolicy Bypass -File scripts/publish.ps1"
+  }
+}