@absolutejs/mcp 0.4.1 → 0.4.3

package/dist/manifest.json

@@ -0,0 +1,124 @@
+{
+	"contract": 1,
+	"identity": {
+		"accent": "#0ea5e9",
+		"category": "ai",
+		"description": "Serve a remote Model Context Protocol endpoint (streamable HTTP, stateless) from your Elysia app. Bridge installed AbsoluteJS packages' manifests with `toMcpToolRegistry` and their tools become callable by any connected MCP client; OAuth bearer auth, RFC 9728 discovery, and per-call guards are yours to wire.",
+		"docsUrl": "https://github.com/absolutejs/mcp",
+		"name": "@absolutejs/mcp",
+		"tagline": "Let AI assistants connect to your site and use its tools."
+	},
+	"requires": {
+		"peers": [
+			{
+				"name": "elysia",
+				"range": ">=1.1.0",
+				"reason": "plugin host"
+			}
+		]
+	},
+	"settings": {
+		"type": "object",
+		"required": [
+			"issuer",
+			"path"
+		],
+		"properties": {
+			"instructions": {
+				"description": "A short note shown to the AI about what this server does and how to use it.",
+				"title": "Instructions for the AI",
+				"type": "string"
+			},
+			"issuer": {
+				"description": "The web address of the sign-in server that issues access tokens for this endpoint. Usually your site's own address.",
+				"examples": [
+					"https://yoursite.com"
+				],
+				"format": "uri",
+				"title": "Token issuer",
+				"type": "string"
+			},
+			"path": {
+				"default": "/mcp",
+				"description": "Where on your site the AI endpoint lives.",
+				"title": "Endpoint path",
+				"type": "string"
+			},
+			"scopesSupported": {
+				"description": "The permission scopes this endpoint advertises to connecting clients.",
+				"examples": [
+					[
+						"openid",
+						"mcp"
+					]
+				],
+				"title": "Advertised scopes",
+				"x-group": "advanced",
+				"type": "array",
+				"items": {
+					"type": "string"
+				}
+			},
+			"serveRootMetadata": {
+				"description": "Also answer discovery requests at the site root. Turn on for exactly one endpoint per site.",
+				"title": "Answer root discovery",
+				"x-group": "advanced",
+				"type": "boolean"
+			},
+			"serverInfo": {
+				"description": "How this server introduces itself to connecting AI clients.",
+				"title": "Server identity",
+				"type": "object",
+				"properties": {
+					"name": {
+						"title": "Machine name",
+						"examples": [
+							"your-site"
+						],
+						"type": "string"
+					},
+					"title": {
+						"title": "Display name",
+						"examples": [
+							"Your Site"
+						],
+						"type": "string"
+					},
+					"version": {
+						"title": "Version",
+						"examples": [
+							"1.0.0"
+						],
+						"type": "string"
+					}
+				}
+			}
+		}
+	},
+	"wiring": [
+		{
+			"description": "Mount a remote MCP endpoint that serves the tools of installed AbsoluteJS packages — bridge each package's manifest and any MCP client (Claude, etc.) can call them.",
+			"id": "default",
+			"server": {
+				"code": ".use(\n\tmcpServer({\n\t\t// TODO: decide who may call this endpoint — see verifyBearer for\n\t\t// the standard OAuth bearer-token checks. Denies everyone until\n\t\t// you wire it.\n\t\tauthorize: async () => ({\n\t\t\tok: false,\n\t\t\treason: 'authorization not configured'\n\t\t}),\n\t\tinstructions: ${settings.instructions},\n\t\tissuer: ${settings.issuer},\n\t\tpath: ${settings.path},\n\t\tscopesSupported: ${settings.scopesSupported},\n\t\tserveRootMetadata: ${settings.serveRootMetadata},\n\t\tserverInfo: ${settings.serverInfo} ?? { name: 'my-site', version: '0.1.0' },\n\t\ttools: async () => {\n\t\t\t// Every installed AbsoluteJS package ships a manifest; bridging\n\t\t\t// it exposes that package's tools here. Pass the live instance\n\t\t\t// you constructed for the package as `runtime` — tools without\n\t\t\t// their binding are omitted (fail closed).\n\t\t\t// TODO: list the packages this endpoint should expose.\n\t\t\tconst exposed: { name: string; runtime?: unknown }[] = [];\n\t\t\tconst registries = await Promise.all(\n\t\t\t\texposed.map(async ({ name, runtime }) => {\n\t\t\t\t\tconst loaded = await loadManifest(name);\n\n\t\t\t\t\treturn loaded.ok\n\t\t\t\t\t\t? toMcpToolRegistry(loaded.manifest, { runtime })\n\t\t\t\t\t\t: {};\n\t\t\t\t})\n\t\t\t);\n\n\t\t\treturn Object.assign({}, ...registries);\n\t\t}\n\t})\n)",
+				"imports": [
+					{
+						"from": "@absolutejs/mcp",
+						"names": [
+							"mcpServer"
+						]
+					},
+					{
+						"from": "@absolutejs/manifest",
+						"names": [
+							"loadManifest",
+							"toMcpToolRegistry"
+						]
+					}
+				],
+				"placement": "server-plugin"
+			},
+			"title": "Serve installed packages' tools over MCP"
+		}
+	]
+}

package/dist/src/index.d.ts

@@ -38,4 +38,4 @@ export { createMcpHandler } from "./handler";
 export { metadataPathFor, protectedResourceMetadata, type ProtectedResourceMetadata, } from "./metadata";
 export { mcpServer } from "./server";
 export { createSessionRegistry, type SessionRegistry } from "./sessions";
-export type { McpAudioContent, McpElicitationRequest, McpElicitResult, McpAuthResult, McpCallGate, McpCallMeta, McpContent, McpImageContent, McpPromptArgument, McpPromptDefinition, McpPrompts, McpResource, McpResourceLink, McpResources, McpServerConfig, McpServerInfo, McpTextContent, McpTool, McpToolAnnotations, McpToolCallContext, McpToolContext, McpToolRegistry, McpToolResult, McpToolReturn, } from "./types";
+export type { McpAudioContent, McpElicitAnswer, McpElicitationRequest, McpElicitBus, McpElicitResult, McpSessionStore, McpAuthResult, McpCallGate, McpCallMeta, McpContent, McpImageContent, McpPromptArgument, McpPromptDefinition, McpPrompts, McpResource, McpResourceLink, McpResources, McpServerConfig, McpServerInfo, McpTextContent, McpTool, McpToolAnnotations, McpToolCallContext, McpToolContext, McpToolRegistry, McpToolResult, McpToolReturn, } from "./types";

package/dist/src/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { McpServerConfig } from "./types";
+export declare const manifest: import("@absolutejs/manifest").PackageManifest<McpServerConfig<unknown>, never>;

package/package.json

@@ -10,7 +10,27 @@
   "peerDependencies": {
     "elysia": ">=1.1.0"
   },
+  "dependencies": {
+    "@absolutejs/manifest": "^0.1.0",
+    "@sinclair/typebox": "^0.34.0"
+  },
   "license": "BUSL-1.1",
+  "absolutejs": {
+    "manifestContract": 1
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./manifest": {
+      "types": "./dist/src/manifest.d.ts",
+      "import": "./dist/manifest.js",
+      "default": "./dist/manifest.js"
+    },
+    "./manifest.json": "./dist/manifest.json"
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -30,12 +50,12 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "rm -rf dist && bun build src/index.ts --outdir dist --target=bun --external elysia && tsc --emitDeclarationOnly --project tsconfig.json",
+    "build": "rm -rf dist && bun build src/index.ts src/manifest.ts --outdir dist --root ./src --target=bun --external elysia && tsc --emitDeclarationOnly --project tsconfig.json && absolute-manifest emit",
     "format": "prettier --write \"./**/*.{ts,json,md}\"",
     "release": "bun run format && bun run test && bun run build && bun publish",
     "test": "bun test",
     "typecheck": "tsc --noEmit --project tsconfig.json"
   },
   "types": "./dist/src/index.d.ts",
-  "version": "0.4.1"
+  "version": "0.4.3"
 }