xmcp 0.8.0 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/client/index.d.ts +4 -5
- package/dist/config.js +1 -1
- package/dist/index.d.ts +3 -3
- package/dist/index.js +38 -27
- package/dist/runtime/adapter-express.js +65 -353
- package/dist/runtime/adapter-fastify.js +65 -353
- package/dist/runtime/adapter-nestjs.js +41 -329
- package/dist/runtime/adapter-nextjs.js +61 -349
- package/dist/runtime/http.js +55 -44
- package/dist/runtime/stdio.js +40 -40
- package/dist/runtime/transports/http/base-streamable-http.d.ts +0 -15
- package/dist/runtime/utils/client-info.d.ts +1 -1
- package/dist/runtime/utils/elicitation.d.ts +3 -4
- package/dist/runtime/utils/prompts.d.ts +1 -1
- package/dist/runtime/utils/resources.d.ts +1 -1
- package/dist/runtime/utils/sampling.d.ts +3 -0
- package/dist/runtime/utils/schema-compat.d.ts +61 -0
- package/dist/runtime/utils/server.d.ts +1 -2
- package/dist/runtime/utils/tools.d.ts +1 -1
- package/dist/runtime/utils/transformers/prompt.d.ts +3 -4
- package/dist/runtime/utils/transformers/resource.d.ts +3 -4
- package/dist/runtime/utils/transformers/tool.d.ts +3 -4
- package/dist/types/middleware.d.ts +1 -1
- package/dist/types/tool.d.ts +18 -1
- package/package.json +15 -7
package/dist/client/index.d.ts
CHANGED
|
@@ -1,6 +1,5 @@
|
|
|
1
|
-
import { Client } from "@modelcontextprotocol/
|
|
2
|
-
import { StdioClientTransport, type StdioServerParameters } from "@modelcontextprotocol/
|
|
3
|
-
import { Request, Result, Notification } from "@modelcontextprotocol/sdk/types.js";
|
|
1
|
+
import { Client } from "@modelcontextprotocol/client";
|
|
2
|
+
import { StdioClientTransport, type StdioServerParameters } from "@modelcontextprotocol/client/stdio";
|
|
4
3
|
import type { Buffer } from "node:buffer";
|
|
5
4
|
import { CustomHeaders } from "./headers";
|
|
6
5
|
export declare const CLIENT_IDENTITY: {
|
|
@@ -15,7 +14,7 @@ interface HttpClientOptions {
|
|
|
15
14
|
/**
|
|
16
15
|
* Pure direct HTTP MCP client (no proxy, no SSE, no stdio)
|
|
17
16
|
*/
|
|
18
|
-
export declare function createHTTPClient({ url, headers, }: HttpClientOptions): Promise<Client
|
|
17
|
+
export declare function createHTTPClient({ url, headers, }: HttpClientOptions): Promise<Client>;
|
|
19
18
|
export interface StdioClientOptions extends StdioServerParameters {
|
|
20
19
|
/**
|
|
21
20
|
* Optional hook that receives stderr chunks when the transport
|
|
@@ -24,7 +23,7 @@ export interface StdioClientOptions extends StdioServerParameters {
|
|
|
24
23
|
onStderrData?: (chunk: Buffer) => void;
|
|
25
24
|
}
|
|
26
25
|
export interface StdioClientConnection {
|
|
27
|
-
client: Client
|
|
26
|
+
client: Client;
|
|
28
27
|
transport: StdioClientTransport;
|
|
29
28
|
}
|
|
30
29
|
/**
|
package/dist/config.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
!function(e,t){if("object"==typeof exports&&"object"==typeof module)module.exports=t(require("zod/v3"));else if("function"==typeof define&&define.amd)define(["zod/v3"],t);else{var o="object"==typeof exports?t(require("zod/v3")):t(e["zod/v3"]);for(var r in o)("object"==typeof exports?exports:e)[r]=o[r]}}(this,e=>(()=>{"use strict";var t={4953(t){t.exports=e}},o={};function r(e){var n=o[e];if(void 0!==n)return n.exports;var s=o[e]={exports:{}};return t[e](s,s.exports,r),s.exports}r.n=e=>{var t=e&&e.__esModule?()=>e.default:()=>e;return r.d(t,{a:t}),t},r.d=(e,t)=>{for(var o in t)r.o(t,o)&&!r.o(e,o)&&Object.defineProperty(e,o,{enumerable:!0,get:t[o]})},r.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),r.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var n={};return(()=>{r.r(n),r.d(n,{getResolvedHttpConfig:()=>A,configSchema:()=>_,getResolvedStdioConfig:()=>E,getResolvedTypescriptConfig:()=>M,getResolvedCorsConfig:()=>S,getResolvedPathsConfig:()=>T,getResolvedExperimentalConfig:()=>R,getResolvedTemplateConfig:()=>P});var e=r(4953),t=r.n(e);let o=["x-mcp-client-name","x-mcp-client-version","x-mcp-client-title","x-mcp-client-website-url","x-mcp-client-description"],s={origin:"*",methods:["GET","POST"],allowedHeaders:["Content-Type","Authorization","mcp-session-id","mcp-protocol-version",...o],exposedHeaders:["Content-Type","Authorization","mcp-session-id"],credentials:!1,maxAge:86400},l=e.z.object({origin:e.z.union([e.z.string(),e.z.array(e.z.string()),e.z.boolean()]).default(s.origin),methods:e.z.union([e.z.string(),e.z.array(e.z.string())]).default([...s.methods]),allowedHeaders:e.z.union([e.z.string(),e.z.array(e.z.string())]).default([...s.allowedHeaders]),exposedHeaders:e.z.union([e.z.string(),e.z.array(e.z.string())]).default([...s.exposedHeaders]),credentials:e.z.boolean().default(s.credentials),maxAge:e.z.number().default(s.maxAge)}),i=l.parse({}),a=l.partial().transform(e=>{let t=Object.fromEntries(Object.entries(e).filter(([e,t])=>void 0!==t)),r={...i,...t};if(Array.isArray(r.allowedHeaders)){let e=new Set(r.allowedHeaders);for(let t of(e.add("mcp-session-id"),e.add("mcp-protocol-version"),o))e.add(t);r.allowedHeaders=Array.from(e)}if(Array.isArray(r.exposedHeaders)){let e=new Set(r.exposedHeaders);e.add("mcp-session-id"),r.exposedHeaders=Array.from(e)}return r}),p=e.z.object({port:e.z.number().default(3001),host:e.z.string().default("127.0.0.1"),bodySizeLimit:e.z.number().default(0xa00000),debug:e.z.boolean().default(!1),endpoint:e.z.string().default("/mcp"),cors:a}),u=p.partial().transform(e=>{let t=p.parse({cors:{}}),o=Object.fromEntries(Object.entries(e).filter(([e,t])=>void 0!==t));return{...t,...o}}),d=e.z.union([e.z.boolean(),u]);d.transform(e=>"boolean"==typeof e?e?{}:null:e).pipe(e.z.union([e.z.literal(null),u]));let f=e.z.object({debug:e.z.boolean().default(!1),silent:e.z.boolean().default(!1)}),c=f.partial().transform(e=>{let t=f.parse({}),o=Object.fromEntries(Object.entries(e).filter(([e,t])=>void 0!==t));return{...t,...o}}),m=e.z.union([e.z.boolean(),c]).optional(),z=e.z.enum(["express","nextjs","nestjs","fastify"]),b=e.z.object({adapter:z.optional()}),g=e.z.object({tools:e.z.union([e.z.boolean(),e.z.string()]).default(!0),prompts:e.z.union([e.z.boolean(),e.z.string()]).default(!0),resources:e.z.union([e.z.boolean(),e.z.string()]).default(!0)}),y=g.partial().transform(e=>{let t=g.parse({}),o=Object.fromEntries(Object.entries(e).filter(([e,t])=>void 0!==t));return{...t,...o}}),j="src/tools",v="src/prompts",x="src/resources",h=t().function().args(t().any()).returns(t().any()).optional(),O=e.z.object({name:e.z.string().default("xmcp server"),description:e.z.string().default("This MCP server was bootstrapped with xmcp."),icons:e.z.array(e.z.object({src:e.z.string(),mimeType:e.z.string().optional(),sizes:e.z.array(e.z.string()).optional(),theme:e.z.enum(["light","dark"]).optional()})).optional(),instructions:e.z.string().optional(),homePage:e.z.string().optional()}),H=O.partial().transform(e=>{let t=O.parse({}),o=Object.fromEntries(Object.entries(e).filter(([e,t])=>void 0!==t));return{...t,...o}}),w=e.z.object({skipTypeCheck:e.z.boolean().default(!1)}),C=w.partial().transform(e=>{let t=w.parse({}),o=Object.fromEntries(Object.entries(e).filter(([e,t])=>void 0!==t));return{...t,...o}});function A(e){if("boolean"==typeof e){if(!e)return null;let t=d.parse({});return"object"!=typeof t||null===t?null:t}if("object"==typeof e&&null!==e){let t=d.parse(e);return"object"!=typeof t||null===t?null:t}return null}function S(e){return a.parse(e?.cors??{})}function T(e){let t=e?.paths;if(!t)return{tools:j,prompts:v,resources:x};let o={tools:j,prompts:v,resources:x};return"boolean"==typeof t.tools?o.tools=t.tools?j:null:"string"==typeof t.tools&&(o.tools=t.tools),"boolean"==typeof t.prompts?o.prompts=t.prompts?v:null:"string"==typeof t.prompts&&(o.prompts=t.prompts),"boolean"==typeof t.resources?o.resources=t.resources?x:null:"string"==typeof t.resources&&(o.resources=t.resources),o}function E(e){let t=e?.stdio;if("boolean"==typeof t){if(!t)return null;let e=m.parse({});return"object"!=typeof e||null===e?null:e}if(t){let e=m.parse(t);return"object"!=typeof e||null===e?null:e}let o=m.parse({});return"object"!=typeof o||null===o?null:o}function P(e){let t=e?.template;return H.parse(t??{})}function R(e){let t=e?.experimental;return{adapter:t?.adapter}}function M(e){let t=e?.typescript;return C.parse(t??{})}let _=e.z.object({stdio:m.optional(),http:d.optional(),experimental:b.optional(),paths:y.optional(),bundler:h.optional(),template:H.optional(),typescript:C.optional()})})(),n})());
|
|
1
|
+
!function(e,t){if("object"==typeof exports&&"object"==typeof module)module.exports=t(require("zod/v3"));else if("function"==typeof define&&define.amd)define(["zod/v3"],t);else{var o="object"==typeof exports?t(require("zod/v3")):t(e["zod/v3"]);for(var r in o)("object"==typeof exports?exports:e)[r]=o[r]}}(this,e=>(()=>{"use strict";var t={4953(t){t.exports=e}},o={};function r(e){var n=o[e];if(void 0!==n)return n.exports;var s=o[e]={exports:{}};return t[e](s,s.exports,r),s.exports}r.n=e=>{var t=e&&e.__esModule?()=>e.default:()=>e;return r.d(t,{a:t}),t},r.d=(e,t)=>{for(var o in t)r.o(t,o)&&!r.o(e,o)&&Object.defineProperty(e,o,{enumerable:!0,get:t[o]})},r.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),r.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var n={};return(()=>{r.r(n),r.d(n,{getResolvedHttpConfig:()=>A,configSchema:()=>_,getResolvedStdioConfig:()=>E,getResolvedTypescriptConfig:()=>M,getResolvedCorsConfig:()=>S,getResolvedPathsConfig:()=>T,getResolvedExperimentalConfig:()=>R,getResolvedTemplateConfig:()=>P});var e=r(4953),t=r.n(e);let o=["x-mcp-client-name","x-mcp-client-version","x-mcp-client-title","x-mcp-client-website-url","x-mcp-client-description"],s={origin:"*",methods:["GET","POST"],allowedHeaders:["Content-Type","Authorization","mcp-session-id","mcp-protocol-version","mcp-method","mcp-name",...o],exposedHeaders:["Content-Type","Authorization","mcp-session-id"],credentials:!1,maxAge:86400},l=e.z.object({origin:e.z.union([e.z.string(),e.z.array(e.z.string()),e.z.boolean()]).default(s.origin),methods:e.z.union([e.z.string(),e.z.array(e.z.string())]).default([...s.methods]),allowedHeaders:e.z.union([e.z.string(),e.z.array(e.z.string())]).default([...s.allowedHeaders]),exposedHeaders:e.z.union([e.z.string(),e.z.array(e.z.string())]).default([...s.exposedHeaders]),credentials:e.z.boolean().default(s.credentials),maxAge:e.z.number().default(s.maxAge)}),i=l.parse({}),a=l.partial().transform(e=>{let t=Object.fromEntries(Object.entries(e).filter(([e,t])=>void 0!==t)),r={...i,...t};if(Array.isArray(r.allowedHeaders)){let e=new Set(r.allowedHeaders);for(let t of(e.add("mcp-session-id"),e.add("mcp-protocol-version"),e.add("mcp-method"),e.add("mcp-name"),o))e.add(t);r.allowedHeaders=Array.from(e)}if(Array.isArray(r.exposedHeaders)){let e=new Set(r.exposedHeaders);e.add("mcp-session-id"),r.exposedHeaders=Array.from(e)}return r}),p=e.z.object({port:e.z.number().default(3001),host:e.z.string().default("127.0.0.1"),bodySizeLimit:e.z.number().default(0xa00000),debug:e.z.boolean().default(!1),endpoint:e.z.string().default("/mcp"),cors:a}),u=p.partial().transform(e=>{let t=p.parse({cors:{}}),o=Object.fromEntries(Object.entries(e).filter(([e,t])=>void 0!==t));return{...t,...o}}),d=e.z.union([e.z.boolean(),u]);d.transform(e=>"boolean"==typeof e?e?{}:null:e).pipe(e.z.union([e.z.literal(null),u]));let f=e.z.object({debug:e.z.boolean().default(!1),silent:e.z.boolean().default(!1)}),c=f.partial().transform(e=>{let t=f.parse({}),o=Object.fromEntries(Object.entries(e).filter(([e,t])=>void 0!==t));return{...t,...o}}),m=e.z.union([e.z.boolean(),c]).optional(),z=e.z.enum(["express","nextjs","nestjs","fastify"]),b=e.z.object({adapter:z.optional()}),g=e.z.object({tools:e.z.union([e.z.boolean(),e.z.string()]).default(!0),prompts:e.z.union([e.z.boolean(),e.z.string()]).default(!0),resources:e.z.union([e.z.boolean(),e.z.string()]).default(!0)}),y=g.partial().transform(e=>{let t=g.parse({}),o=Object.fromEntries(Object.entries(e).filter(([e,t])=>void 0!==t));return{...t,...o}}),j="src/tools",v="src/prompts",x="src/resources",h=t().function().args(t().any()).returns(t().any()).optional(),O=e.z.object({name:e.z.string().default("xmcp server"),description:e.z.string().default("This MCP server was bootstrapped with xmcp."),icons:e.z.array(e.z.object({src:e.z.string(),mimeType:e.z.string().optional(),sizes:e.z.array(e.z.string()).optional(),theme:e.z.enum(["light","dark"]).optional()})).optional(),instructions:e.z.string().optional(),homePage:e.z.string().optional()}),H=O.partial().transform(e=>{let t=O.parse({}),o=Object.fromEntries(Object.entries(e).filter(([e,t])=>void 0!==t));return{...t,...o}}),w=e.z.object({skipTypeCheck:e.z.boolean().default(!1)}),C=w.partial().transform(e=>{let t=w.parse({}),o=Object.fromEntries(Object.entries(e).filter(([e,t])=>void 0!==t));return{...t,...o}});function A(e){if("boolean"==typeof e){if(!e)return null;let t=d.parse({});return"object"!=typeof t||null===t?null:t}if("object"==typeof e&&null!==e){let t=d.parse(e);return"object"!=typeof t||null===t?null:t}return null}function S(e){return a.parse(e?.cors??{})}function T(e){let t=e?.paths;if(!t)return{tools:j,prompts:v,resources:x};let o={tools:j,prompts:v,resources:x};return"boolean"==typeof t.tools?o.tools=t.tools?j:null:"string"==typeof t.tools&&(o.tools=t.tools),"boolean"==typeof t.prompts?o.prompts=t.prompts?v:null:"string"==typeof t.prompts&&(o.prompts=t.prompts),"boolean"==typeof t.resources?o.resources=t.resources?x:null:"string"==typeof t.resources&&(o.resources=t.resources),o}function E(e){let t=e?.stdio;if("boolean"==typeof t){if(!t)return null;let e=m.parse({});return"object"!=typeof e||null===e?null:e}if(t){let e=m.parse(t);return"object"!=typeof e||null===e?null:e}let o=m.parse({});return"object"!=typeof o||null===o?null:o}function P(e){let t=e?.template;return H.parse(t??{})}function R(e){let t=e?.experimental;return{adapter:t?.adapter}}function M(e){let t=e?.typescript;return C.parse(t??{})}let _=e.z.object({stdio:m.optional(),http:d.optional(),experimental:b.optional(),paths:y.optional(),bundler:h.optional(),template:H.optional(),typescript:C.optional()})})(),n})());
|
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
export type { Middleware, WebMiddleware, WebMiddlewareContext, } from "./types/middleware";
|
|
2
|
-
export type { ToolMetadata, ToolSchema, ToolOutputSchema, ToolExtraArguments, InferSchema, ElicitResult, } from "./types/tool";
|
|
2
|
+
export type { ToolMetadata, ToolSchema, ToolOutputSchema, ToolExtraArguments, InferSchema, ElicitResult, SampleRequest, SampleResult, } from "./types/tool";
|
|
3
3
|
export type { McpClientInfo } from "./types/client-info";
|
|
4
4
|
export type { PromptMetadata } from "./types/prompt";
|
|
5
5
|
export type { ResourceMetadata } from "./types/resource";
|
|
@@ -9,8 +9,8 @@ import "./types/declarations";
|
|
|
9
9
|
export { apiKeyAuthMiddleware } from "./auth/api-key";
|
|
10
10
|
export { jwtAuthMiddleware } from "./auth/jwt";
|
|
11
11
|
export { createContext } from "./utils/context";
|
|
12
|
-
export { completable } from "@modelcontextprotocol/
|
|
13
|
-
export {
|
|
12
|
+
export { completable, UrlElicitationRequiredError, inputRequired, inputResponse, acceptedContent, isInputRequiredResult, createRequestStateCodec, } from "@modelcontextprotocol/server";
|
|
13
|
+
export type { InputRequiredResult, InputRequests, InputResponses, RequestStateCodec, } from "@modelcontextprotocol/server";
|
|
14
14
|
export { createHTTPClient, createSTDIOClient, listSTDIOClientTools, callSTDIOClientTool, disconnectSTDIOClient, } from "./client";
|
|
15
15
|
export type { HttpClient, StdioClient, StdioIOStrategy, ClientConnectionEntry, ClientConnections, ClientDefinition, HttpClientConfig, StdioClientConfig, } from "./client/types";
|
|
16
16
|
export type { StdioClientConnection, StdioClientOptions } from "./client";
|