Files
myeasycms-v2/packages/mcp-server/AGENTS.md
Giancarlo Buomprisco f3ac595d06 MCP Server 2.0 (#452)
* MCP Server 2.0

- Updated application version from 2.23.14 to 2.24.0 in package.json.
- MCP Server improved with new features
- Migrated functionality from Dev Tools to MCP Server
- Improved getMonitoringProvider not to crash application when misconfigured
2026-02-11 20:42:01 +01:00

865 B

MCP Server Instructions

This package owns Makerkit MCP tool/resource registration and adapters.

Non-negotiables

  1. Use service pattern: keep business/domain logic in *.service.ts, not MCP handlers.
  2. index.ts in each tool folder is adapter only: parse input, call service, map output/errors.
  3. Inject deps via create*Deps + create*Service; avoid hidden globals/singletons.
  4. Keep schemas in schema.ts; validate all tool input with zod before service call.
  5. Export public registration + service factory/types from each tool index.ts.
  6. Add/maintain unit tests for service behavior and tool adapter behavior.
  7. Register new tools/resources in src/index.ts.
  8. Keep tool responses structured + stable; avoid breaking output shapes.

Service pattern is required to decouple logic from MCP server transport and keep logic testable/reusable.