mcp2service 1.0.0

package/dist/types/adapters/factory.d.ts

@@ -0,0 +1,10 @@
+import type { ServiceAdapter, AdapterFactory } from '../types';
+export declare class DefaultAdapterFactory implements AdapterFactory {
+    private adapterRegistry;
+    constructor();
+    private registerDefaultAdapters;
+    createAdapter(type: string, options: Record<string, any>): ServiceAdapter;
+    registerAdapter(type: string, adapterClass: new () => ServiceAdapter): void;
+    getSupportedTypes(): string[];
+}
+export declare const defaultAdapterFactory: DefaultAdapterFactory;

package/dist/types/adapters/graphql.d.ts

@@ -0,0 +1,28 @@
+import type { AudioContent, ContentResult, Context, ImageContent, ResourceContent, ResourceLink, TextContent } from 'fastmcp';
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+import type { ServiceAdapter } from '../types';
+import { z } from 'zod';
+export declare const graphqlAdapterConfigSchema: z.ZodObject<{
+    endpoint: z.ZodString;
+    headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    operationName: z.ZodOptional<z.ZodString>;
+    variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    retry: z.ZodOptional<z.ZodObject<{
+        attempts: z.ZodDefault<z.ZodNumber>;
+        backoff: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type GraphQLAdapterConfig = z.infer<typeof graphqlAdapterConfigSchema>;
+export declare class GraphQLAdapter implements ServiceAdapter {
+    private adapterConfig;
+    private endpoint;
+    private headers;
+    private timeout?;
+    private retryConfig?;
+    private operationName?;
+    private defaultVariables?;
+    config(options: Record<string, any>): void;
+    private executeWithRetry;
+    call(args: StandardSchemaV1.InferOutput<any>, context: Context<any>): Promise<AudioContent | ContentResult | ImageContent | ResourceContent | ResourceLink | string | TextContent | void>;
+}

package/dist/types/adapters/grpc.d.ts

@@ -0,0 +1,32 @@
+import type { AudioContent, ContentResult, Context, ImageContent, ResourceContent, ResourceLink, TextContent } from 'fastmcp';
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+import type { ServiceAdapter } from '../types';
+import { z } from 'zod';
+export declare const grpcAdapterConfigSchema: z.ZodObject<{
+    protoPath: z.ZodString;
+    serviceName: z.ZodString;
+    methodName: z.ZodString;
+    address: z.ZodString;
+    credentials: z.ZodDefault<z.ZodEnum<{
+        insecure: "insecure";
+        ssl: "ssl";
+    }>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    retry: z.ZodOptional<z.ZodObject<{
+        attempts: z.ZodDefault<z.ZodNumber>;
+        backoff: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type GrpcAdapterConfig = z.infer<typeof grpcAdapterConfigSchema>;
+export declare class GrpcAdapter implements ServiceAdapter {
+    private adapterConfig;
+    private client;
+    private packageDefinition;
+    private proto;
+    config(options: Record<string, any>): void;
+    private _loadProto;
+    private _getClient;
+    private executeWithRetry;
+    call(args: StandardSchemaV1.InferOutput<any>, context: Context<any>): Promise<AudioContent | ContentResult | ImageContent | ResourceContent | ResourceLink | string | TextContent | void>;
+}

package/dist/types/adapters/http.d.ts

@@ -0,0 +1,15 @@
+import 'axios';
+import type { AudioContent, ContentResult, Context, ImageContent, ResourceContent, ResourceLink, TextContent } from 'fastmcp';
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+import type { ServiceAdapter } from '../types';
+export declare class HttpAdapter implements ServiceAdapter {
+    private url;
+    private method;
+    private headers;
+    private axiosConfig;
+    private timeout?;
+    private retryConfig?;
+    config(option: Record<string, any>): void;
+    private executeWithRetry;
+    call(args: StandardSchemaV1.InferOutput<any>, context: Context<any>): Promise<AudioContent | ContentResult | ImageContent | ResourceContent | ResourceLink | string | TextContent | void>;
+}

package/dist/types/adapters/index.d.ts

@@ -0,0 +1,4 @@
+export * from './http';
+export * from './graphql';
+export * from './grpc';
+export * from './factory';

package/dist/types/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/types/errors.d.ts

@@ -0,0 +1,23 @@
+export declare class MCPError extends Error {
+    readonly code: string;
+    readonly statusCode?: number | undefined;
+    readonly details?: Record<string, any> | undefined;
+    constructor(message: string, code: string, statusCode?: number | undefined, details?: Record<string, any> | undefined);
+}
+export declare class ValidationError extends MCPError {
+    constructor(message: string, details?: Record<string, any>);
+}
+export declare class ConfigurationError extends MCPError {
+    constructor(message: string, details?: Record<string, any>);
+}
+export declare class AdapterError extends MCPError {
+    readonly adapterName: string;
+    constructor(message: string, adapterName: string, details?: Record<string, any>);
+}
+export declare class AuthenticationError extends MCPError {
+    constructor(message: string, details?: Record<string, any>);
+}
+export declare class RateLimitError extends MCPError {
+    constructor(message: string, details?: Record<string, any>);
+}
+export type ErrorType = 'VALIDATION_ERROR' | 'CONFIGURATION_ERROR' | 'ADAPTER_ERROR' | 'AUTHENTICATION_ERROR' | 'RATE_LIMIT_ERROR' | 'INTERNAL_ERROR';

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './mpc-proxy';
+export * from './types';
+export * from './adapters';

package/dist/types/mpc-proxy.d.ts

@@ -0,0 +1,12 @@
+import { FastMCP } from 'fastmcp';
+import * as types from './types';
+export declare class McpProxy {
+    server: FastMCP | undefined;
+    private _toolhandlers;
+    private validatedOptions;
+    constructor(options: types.McpOptions);
+    _createMcpServer(): void;
+    private _registerTool;
+    private _convertTransportForFastMCP;
+    start(): Promise<void>;
+}

package/dist/types/types.d.ts

@@ -0,0 +1,45 @@
+import * as http from "http";
+import type { AudioContent, ContentResult, Context, ImageContent, ResourceContent, ResourceLink, TextContent, ToolParameters } from 'fastmcp';
+import type { StandardSchemaV1 } from "@standard-schema/spec";
+import type { EventStore } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import type { ValidatedMcpOptions as _ValidatedMcpOptions } from './validation';
+type Authenticate<T> = (request: http.IncomingMessage) => Promise<T>;
+export interface McpOptions {
+    name: string;
+    version: `${number}.${number}.${number}`;
+    headers?: Array<string>;
+    authedFn?: Authenticate<Record<string, any>>;
+    transport: Partial<{
+        httpStream: {
+            enableJsonResponse?: boolean;
+            endpoint?: `/${string}`;
+            eventStore?: EventStore;
+            host?: string;
+            port: number;
+            stateless?: boolean;
+        };
+        transportType: "httpStream" | "stdio";
+    }>;
+    tools: {
+        [toolName: string]: ToolDefine;
+    };
+}
+export type ValidatedMcpOptions = _ValidatedMcpOptions;
+export interface ToolDefine {
+    type: string;
+    description?: string;
+    params: ToolParameters;
+    options: Record<string, any>;
+    execute?: ToolFn;
+}
+export type ToolFn = (args: StandardSchemaV1.InferOutput<any>, context: Context<any>) => Promise<AudioContent | ContentResult | ImageContent | ResourceContent | ResourceLink | string | TextContent | void>;
+export interface ServiceAdapter {
+    config(option: Record<string, any>): void;
+    call: ToolFn;
+}
+export interface AdapterFactory {
+    createAdapter(type: string, options: Record<string, any>): ServiceAdapter;
+    registerAdapter(type: string, adapterClass: new () => ServiceAdapter): void;
+    getSupportedTypes(): string[];
+}
+export {};

package/dist/types/validation.d.ts

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import type { IncomingMessage } from 'http';
+export declare const mcpOptionsSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    headers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    authedFn: z.ZodOptional<z.ZodCustom<(request: IncomingMessage) => Promise<Record<string, any>>, (request: IncomingMessage) => Promise<Record<string, any>>>>;
+    transport: z.ZodObject<{
+        httpStream: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            enableJsonResponse: z.ZodOptional<z.ZodBoolean>;
+            endpoint: z.ZodOptional<z.ZodString>;
+            eventStore: z.ZodOptional<z.ZodAny>;
+            host: z.ZodOptional<z.ZodString>;
+            port: z.ZodNumber;
+            stateless: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        transportType: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+            httpStream: "httpStream";
+            stdio: "stdio";
+        }>>>;
+    }, z.core.$strip>;
+    tools: z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        params: z.ZodAny;
+        options: z.ZodRecord<z.ZodString, z.ZodAny>;
+        execute: z.ZodOptional<z.ZodCustom<(args: any, context: any) => Promise<any>, (args: any, context: any) => Promise<any>>>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export declare const toolParamsSchema: z.ZodObject<{}, z.core.$loose>;
+export declare const httpAdapterConfigSchema: z.ZodObject<{
+    url: z.ZodString;
+    method: z.ZodDefault<z.ZodEnum<{
+        GET: "GET";
+        POST: "POST";
+        PUT: "PUT";
+        DELETE: "DELETE";
+        PATCH: "PATCH";
+    }>>;
+    headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    retry: z.ZodOptional<z.ZodObject<{
+        attempts: z.ZodDefault<z.ZodNumber>;
+        backoff: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare function validate<T>(schema: z.ZodSchema<T>, data: unknown, context?: string): T;
+export type ValidatedMcpOptions = z.infer<typeof mcpOptionsSchema>;
+export type ValidatedHttpAdapterConfig = z.infer<typeof httpAdapterConfigSchema>;

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "mcp2service",
+  "version": "1.0.0",
+  "description": "Model Context Protocol代理服务，支持通过多种适配器将工具调用代理到后端服务",
+
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+
+  "module": "./dist/esm/index.js",
+
+  "types": "./dist/types/index.d.ts",
+  "bin": {
+    "mcp2service": "./dist/cli/cli.js"
+  },
+  "exports": {
+
+    ".": {
+
+      "import": "./dist/esm/index.js",
+
+      "require": "./dist/cjs/index.js",
+
+      "types": "./dist/types/index.d.ts"
+
+    }
+
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "bun run index.ts",
+    "dev": "bun --watch index.ts",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "lint": "bun run lint:check",
+    "lint:check": "eslint . --ext .ts",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "format": "prettier --write \"**/*.{ts,js,json,md,yaml,yml}\"",
+    "cli": "bun run cli.ts",
+    "build": "npm run build:cjs && npm run build:esm && npm run build:types && npm run build:cli",
+
+    "build:cjs": "bun build --outdir dist/cjs --format cjs --target node ./index.ts --minify",   
+
+    "build:esm": "bun build --outdir dist/esm --format esm --target node ./index.ts --minify",
+
+    "build:types": "tsc --emitDeclarationOnly -d --outdir dist/types",
+
+    "build:cli": " bun build --outdir dist/cli cli.ts --target node",
+    "postbuild": "chmod +x dist/cli/cli.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "proxy",
+    "adapter",
+    "http",
+    "graphql",
+    "grpc"
+  ],
+  "author": "Cheng Guang <kingecg@qq.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/your-org/mcp2service.git"
+  },
+  "bugs": {
+    "url": "https://github.com/your-org/mcp2service/issues"
+  },
+  "homepage": "https://github.com/your-org/mcp2service#readme",
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "latest",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.57.0",
+    "prettier": "^3.0.0"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@grpc/grpc-js": "^1.14.3",
+    "@grpc/proto-loader": "^0.8.0",
+    "@valibot/to-json-schema": "^1.5.0",
+    "axios": "^1.13.2",
+    "commander": "^12.0.0",
+    "effect": "^3.19.15",
+    "fastmcp": "^3.29.0",
+    "sury": "^11.0.0-alpha.4",
+    "yaml": "^2.0.0",
+    "zod": "^4.3.6"
+  }
+}