@empyria/mcp 0.1.0 → 0.1.1

package/AGENTS.md

@@ -1,6 +1,6 @@
 # AGENTS.md
 
-MCP (Model Context Protocol) helpers for **Principia**, a nanoservice framework built
+MCP (Model Context Protocol) helpers for **Empyria**, a nanoservice framework built
 primarily on Bun: publishes Moleculer-shaped `{ name, actions }` service objects as MCP tools.
 
 ## The package split that matters here

package/README.md

@@ -1,6 +1,6 @@
 # @empyria/mcp
 
-[MCP (Model Context Protocol)](https://modelcontextprotocol.io) helpers for **Principia**, a
+[MCP (Model Context Protocol)](https://modelcontextprotocol.io) helpers for **Empyria**, a
 nanoservice framework built primarily on Bun: publish a list of Moleculer-shaped services as
 MCP tools, with JSON Schema input validation via `@empyria/common`'s `createValidator` —
 no Zod, no Ajv, in our own code.
@@ -177,14 +177,14 @@ that same instance — including as `createMcpHandler`'s per-request factory for
 
 ## Modules
 
-| Module                                 | Purpose                                                                                                                                                                                                     |
-| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [lib/Server.js](./lib/Server.js)       | `createMcpServer` — publishes a list of Moleculer-shaped `{ name, actions }` services as MCP tools.                                                                                                         |
-| [lib/Http.js](./lib/Http.js)           | `createMcpHttpHandler` (runtime-agnostic Web-standard handler) and `serveMcpHttp` (Bun-only convenience, wraps `Bun.serve`).                                                                                |
-| [lib/Guard.js](./lib/Guard.js)         | `withMetaGuard` — optional per-service token protection; see above.                                                                                                                                         |
-| [lib/Client.js](./lib/Client.js)       | `createMcpClient`, `connectStdioClient`, `connectHttpClient` — client-side helpers.                                                                                                                         |
-| [lib/Gateway.js](./lib/Gateway.js)     | `createMcpGateway` — aggregates several already-connected upstream MCP clients into one server.                                                                                                             |
-| [lib/Validator.js](./lib/Validator.js) | `principiaJsonSchemaValidator` — adapts `@empyria/common`'s `createValidator` to the MCP SDK's pluggable JSON Schema validator interface, the same extension point its own `ajv`/`cf-worker` providers use. |
+| Module                                 | Purpose                                                                                                                                                                                                   |
+| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [lib/Server.js](./lib/Server.js)       | `createMcpServer` — publishes a list of Moleculer-shaped `{ name, actions }` services as MCP tools.                                                                                                       |
+| [lib/Http.js](./lib/Http.js)           | `createMcpHttpHandler` (runtime-agnostic Web-standard handler) and `serveMcpHttp` (Bun-only convenience, wraps `Bun.serve`).                                                                              |
+| [lib/Guard.js](./lib/Guard.js)         | `withMetaGuard` — optional per-service token protection; see above.                                                                                                                                       |
+| [lib/Client.js](./lib/Client.js)       | `createMcpClient`, `connectStdioClient`, `connectHttpClient` — client-side helpers.                                                                                                                       |
+| [lib/Gateway.js](./lib/Gateway.js)     | `createMcpGateway` — aggregates several already-connected upstream MCP clients into one server.                                                                                                           |
+| [lib/Validator.js](./lib/Validator.js) | `empyriaJsonSchemaValidator` — adapts `@empyria/common`'s `createValidator` to the MCP SDK's pluggable JSON Schema validator interface, the same extension point its own `ajv`/`cf-worker` providers use. |
 
 There is no official JSON-Schema-only convenience API in `@modelcontextprotocol/server` — its
 `registerTool()` still needs a "Standard Schema" (what Zod produces). What _is_ official and

package/lib/Gateway.js

@@ -5,7 +5,7 @@ import { McpServer, fromJsonSchema } from '@modelcontextprotocol/server'
  * arguments are already validated by the upstream server when the call is forwarded. Re-running
  * a second, independent JSON Schema implementation over the same input here would risk rejecting
  * (or silently reshaping) input the upstream itself considers valid, for zero benefit.
- * @type {import('./Validator.js').principiaJsonSchemaValidator}
+ * @type {import('./Validator.js').empyriaJsonSchemaValidator}
  */
 const passthroughValidator = {
 	getValidator: () => (input) => ({ valid: true, data: input }),

package/lib/Server.js

@@ -2,7 +2,7 @@ import { McpServer, fromJsonSchema } from '@modelcontextprotocol/server'
 
 import { defineSchema } from '@empyria/common'
 
-import { principiaJsonSchemaValidator } from './Validator.js'
+import { empyriaJsonSchemaValidator } from './Validator.js'
 import { withMetaGuard } from './Guard.js'
 
 /**
@@ -64,10 +64,7 @@ function registerService(server, service) {
 		// no-params action drops to a single-argument (extra) call instead — silently
 		// handing the caller's own context object to `args` and leaving `extra` (and
 		// therefore any auth context) undefined.
-		config.inputSchema = fromJsonSchema(
-			defineSchema(params ?? {}),
-			principiaJsonSchemaValidator,
-		)
+		config.inputSchema = fromJsonSchema(defineSchema(params ?? {}), empyriaJsonSchemaValidator)
 
 		server.registerTool(`${service.name}.${actionName}`, config, async (args, extra) => {
 			const result = await handler(args ?? {}, extra)

package/lib/Validator.js

@@ -12,10 +12,10 @@ import { createValidator } from '@empyria/common'
  * `@modelcontextprotocol/server`'s `fromJsonSchema`), backed by
  * `@empyria/common`'s `createValidator` — no Ajv, no Zod.
  *
- * `createValidator` throws a `PrincipiaError` on invalid input; this adapts
+ * `createValidator` throws a `EmpyriaError` on invalid input; this adapts
  * that into the provider's `{valid, data, errorMessage}` result shape.
  */
-export const principiaJsonSchemaValidator = {
+export const empyriaJsonSchemaValidator = {
 	/**
 	 * @param {Object} schema - A JSON schema (Draft 2020-12-compatible).
 	 * @returns {(input: unknown) => JsonSchemaValidatorResult}

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@empyria/mcp",
-	"version": "0.1.0",
-	"description": "MCP (Model Context Protocol) helpers for the Principia nanoservice framework",
+	"version": "0.1.1",
+	"description": "MCP (Model Context Protocol) helpers for the Empyria nanoservice framework",
 	"license": "MIT",
 	"author": "Imre Fazekas <imre.fazekas@icloud.com>",
 	"repository": {
@@ -24,8 +24,8 @@
 		"test:watch": "bun test --watch"
 	},
 	"dependencies": {
-		"@empyria/classification": "0.1.0",
-		"@empyria/common": "0.1.0",
+		"@empyria/classification": "0.1.1",
+		"@empyria/common": "0.1.1",
 		"@modelcontextprotocol/client": "2.0.0",
 		"@modelcontextprotocol/server": "2.0.0"
 	},

package/test/Validator.test.js

@@ -1,7 +1,7 @@
 import { describe, test, expect } from 'bun:test'
-import { principiaJsonSchemaValidator } from '../lib/Validator.js'
+import { empyriaJsonSchemaValidator } from '../lib/Validator.js'
 
-describe('principiaJsonSchemaValidator', () => {
+describe('empyriaJsonSchemaValidator', () => {
 	const schema = {
 		type: 'object',
 		properties: { name: { type: 'string' }, age: { type: 'number', default: 0 } },
@@ -9,19 +9,19 @@ describe('principiaJsonSchemaValidator', () => {
 	}
 
 	test('getValidator returns a reusable validator function', () => {
-		const validate = principiaJsonSchemaValidator.getValidator(schema)
+		const validate = empyriaJsonSchemaValidator.getValidator(schema)
 		expect(typeof validate).toBe('function')
 	})
 
 	test('valid input resolves with the (defaulted) data', () => {
-		const validate = principiaJsonSchemaValidator.getValidator(schema)
+		const validate = empyriaJsonSchemaValidator.getValidator(schema)
 		const result = validate({ name: 'Bob' })
 		expect(result.valid).toBe(true)
 		expect(result.data).toEqual({ name: 'Bob', age: 0 })
 	})
 
 	test('invalid input resolves with an error message, not a throw', () => {
-		const validate = principiaJsonSchemaValidator.getValidator(schema)
+		const validate = empyriaJsonSchemaValidator.getValidator(schema)
 		const result = validate({})
 		expect(result.valid).toBe(false)
 		expect(typeof result.errorMessage).toBe('string')