Northern Trust Layer

This repository implements a "Server of Servers" architecture using the Model Context Protocol (MCP). It features a central Orchestrator that aggregates domain-specific data capabilities (like Performance) into a single, governed interface.

Repository Structure

• orchestrator/: The main gateway server. Handles routing and tool aggregation.
• domains/performance/: Sample domain implementation providing fund performance tools.
• package.json: Root configuration for managing the workspace.

Prerequisites

• Node.js (v18+)
• NPM

Setup Instructions

1. Install Dependencies Run from the root directory:

   npm install
   

2. Build the Projects

   npm run build:all
   

3. Run for Testing

   Option A: Test individual domains

   cd domains/performance
   npm run dev
   

   Option B: Test the Orchestrator (Server of Servers)

   cd orchestrator
   npm run dev
   

Key Features

• Namespace Routing: Tools from the Performance domain are automatically prefixed with perf_ by the orchestrator.
• Dynamic Discovery: The orchestrator fetches the tool manifest from domain servers on startup.
• Type Safety: Built with TypeScript and Zod for robust schema validation.
• Standard Protocol: Compatible with any MCP-compliant client (e.g., Gemini, Claude Desktop).

Available Tools (via Orchestrator)

• perf_get_fund_returns: Returns YTD and 1-year performance.
• perf_benchmark_comparison: Compares fund vs benchmark.
• perf_sharpe_ratio: Returns risk-adjusted performance metric.