feat: Add context-aware proxy mode with template support for MCP server configurations

.1mcprc.example

@@ -13,4 +13,96 @@
   // Option 3: Use simple tags (lowest priority)
   // "tags": ["web", "api", "database"],
   // "tags": "web,api,database"  // String format also supported
+
+  // Enable context-aware proxy mode (NEW!)
+  "context": {
+    // Project identifier for template substitution
+    "projectId": "my-awesome-app",
+
+    // Environment for template substitution
+    "environment": "development",
+
+    // Team or organization identifier
+    "team": "platform",
+
+    // Custom context variables available in templates
+    "custom": {
+      "apiEndpoint": "https://api.dev.local",
+      "featureFlags": ["new-ui", "beta-api"],
+      "debugMode": true
+    },
+
+    // Environment variable prefixes to include in context
+    "envPrefixes": ["MY_APP_", "API_"],
+
+    // Enable/disable git information collection
+    "includeGit": true,
+
+    // Sanitize file paths (replace home directory with ~)
+    "sanitizePaths": true
+  }
+}
+
+/*
+Template Examples for MCP Server Configurations:
+
+When context is enabled, you can use templates in your MCP server configurations:
+
+{
+  "name": "project-aware-serena",
+  "command": "npx",
+  "args": [
+    "-y",
+    "serena",
+    "{project.path}",           // Current working directory
+    "{project.name}",           // Project name from context
+    "{project.environment}",    // Environment from context
+    "{user.username}",          // Current user
+    "{project.custom.apiEndpoint}", // Custom context variable
+    "{context.timestamp}"       // Current timestamp
+  ],
+  "env": {
+    "PROJECT_ID": "{project.custom.projectId}",
+    "USER_TEAM": "{project.custom.team}",
+    "GIT_BRANCH": "{project.git.branch?:main}",
+    "SESSION_ID": "{context.sessionId}"
+  }
 }
+
+Available Template Variables:
+
+Project Context:
+  {project.path}        - Current working directory
+  {project.name}        - Project directory name
+  {project.environment} - Environment from context config
+  {project.git.branch}  - Current git branch (if git repo)
+  {project.git.commit}  - Current git commit (short hash)
+  {project.git.repository} - Git repository name
+  {project.custom.*}    - Custom variables from context
+
+User Context:
+  {user.username}       - Current system username
+  {user.name}          - User's display name
+  {user.email}         - User's email (from git config)
+  {user.home}          - User's home directory
+
+Environment Context:
+  {environment.variables.*} - Environment variables
+  {context.path}       - Alias for {project.path}
+  {context.timestamp}  - Current ISO timestamp
+  {context.sessionId}  - Unique session identifier
+  {context.version}    - Context schema version
+
+Template Functions:
+  {variable | upper}           - Convert to uppercase
+  {variable | lower}           - Convert to lowercase
+  {variable | capitalize}      - Capitalize words
+  {variable | truncate(10)}    - Truncate to length
+  {variable | replace(from,to)}- Replace text
+  {variable | basename}        - Get filename from path
+  {variable | dirname}         - Get directory from path
+  {variable | extname}         - Get file extension
+  {variable | default(value)}  - Default value if empty
+
+Example: "{project.name | upper}-{context.timestamp | date('YYYY-MM-DD')}"
+*/

mcp.json.example

@@ -0,0 +1,104 @@
+{
+  "version": "1.0.0",
+  "templateSettings": {
+    "validateOnReload": true,
+    "failureMode": "graceful",
+    "cacheContext": true
+  },
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
+      "env": {},
+      "tags": ["filesystem"]
+    },
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
+      },
+      "tags": ["git", "development"]
+    },
+    "postgres": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-postgres"],
+      "env": {
+        "DATABASE_URL": "${DATABASE_URL}"
+      },
+      "tags": ["database", "production"]
+    }
+  },
+  "mcpTemplates": {
+    "project-serena": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "serena",
+        "{project.path}",
+        "--project", "{project.name}",
+        "--env", "{project.environment}",
+        "--team", "{project.custom.team}"
+      ],
+      "env": {
+        "PROJECT_ID": "{project.custom.projectId}",
+        "SESSION_ID": "{context.sessionId}",
+        "GIT_BRANCH": "{project.git.branch?:main}",
+        "API_ENDPOINT": "{project.custom.apiEndpoint}"
+      },
+      "tags": ["filesystem", "search"]
+    },
+    "context-server": {
+      "command": "node",
+      "args": ["{project.path}/servers/context.js"],
+      "cwd": "{project.path}",
+      "env": {
+        "PROJECT_NAME": "{project.name | upper}",
+        "USER_NAME": "{user.username}",
+        "TIMESTAMP": "{context.timestamp | date('YYYY-MM-DD')}",
+        "DEBUG": "{?project.custom.debugMode:true:false}"
+      },
+      "tags": ["context-aware", "development"],
+      "disabled": "{?project.environment=production}"
+    },
+    "api-server": {
+      "command": "node",
+      "args": ["{project.path}/api/server.js"],
+      "env": {
+        "API_ENDPOINT": "{project.custom.apiEndpoint}",
+        "NODE_ENV": "{project.environment}",
+        "PROJECT_ID": "{project.custom.projectId}",
+        "TEAM": "{project.custom.team}"
+      },
+      "cwd": "{project.path}/services",
+      "tags": ["api", "development"]
+    },
+    "team-tools": {
+      "command": "npx",
+      "args": ["-y", "serena", "{project.path}"],
+      "env": {
+        "PROJECT_NAME": "{project.name}",
+        "TEAM_NAME": "{project.custom.team}",
+        "USER_ROLE": "{user.custom.role}",
+        "API_ENDPOINT": "{project.custom.apiEndpoint}",
+        "ENVIRONMENT": "{project.environment}",
+        "PROJECT_ID": "{project.custom.projectId}",
+        "SESSION_ID": "{context.sessionId}"
+      },
+      "tags": ["{project.custom.team}", "development"],
+      "cwd": "{project.path}"
+    },
+    "conditional-server": {
+      "command": "node",
+      "args": ["{project.path}/conditional-server.js"],
+      "cwd": "{project.path}",
+      "env": {
+        "NODE_ENV": "{project.environment}",
+        "DEBUG": "{?project.environment=development:true}",
+        "LOG_LEVEL": "{?project.environment=production:warn:debug}"
+      },
+      "tags": ["utility"],
+      "disabled": "{?project.environment=production}"
+    }
+  }
+}

src/application/services/healthService.test.ts

@@ -12,6 +12,7 @@ vi.mock('@src/logger/logger.js', () => ({
     warn: vi.fn(),
     debug: vi.fn(),
   },
+  debugIf: vi.fn(),
 }));
 
 vi.mock('@src/core/server/serverManager.js', () => ({

src/auth/sessionTypes.ts

@@ -1,6 +1,8 @@
 // Shared session types for server and client session managers
 import { OAuthClientInformationFull } from '@modelcontextprotocol/sdk/shared/auth.js';
 
+import { ContextNamespace, EnvironmentContext, UserContext } from '@src/types/context.js';
+
 /**
  * Base interface for all data that can expire
  */
@@ -54,4 +56,11 @@ export interface StreamableSessionData extends ExpirableData {
   enablePagination?: boolean;
   customTemplate?: string;
   lastAccessedAt: number;
+  context?: {
+    project?: ContextNamespace;
+    user?: UserContext;
+    environment?: EnvironmentContext;
+    timestamp?: string;
+    version?: string;
+  };
 }

src/auth/storage/authRequestRepository.test.ts

@@ -17,6 +17,7 @@ vi.mock('@src/logger/logger.js', () => ({
     warn: vi.fn(),
     debug: vi.fn(),
   },
+  debugIf: vi.fn(),
 }));
 
 describe('AuthRequestRepository', () => {

src/auth/storage/clientDataRepository.test.ts

@@ -19,6 +19,7 @@ vi.mock('@src/logger/logger.js', () => ({
     warn: vi.fn(),
     debug: vi.fn(),
   },
+  debugIf: vi.fn(),
 }));
 
 describe('ClientDataRepository', () => {

src/commands/mcp/uninstall.test.ts

@@ -23,6 +23,7 @@ vi.mock('@src/logger/logger.js', () => ({
     info: vi.fn(),
     error: vi.fn(),
   },
+  debugIf: vi.fn(),
 }));
 
 const consoleLogMock = vi.fn();

src/commands/mcp/utils/mcpServerConfig.test.ts

@@ -29,6 +29,7 @@ vi.mock('@src/logger/logger.js', () => ({
     warn: vi.fn(),
     error: vi.fn(),
   },
+  debugIf: vi.fn(),
 }));
 
 const mockSetServer = vi.mocked(setServer);

src/commands/mcp/utils/serverUtils.test.ts

@@ -27,6 +27,7 @@ vi.mock('@src/logger/logger.js', () => ({
   default: {
     debug: vi.fn(),
   },
+  debugIf: vi.fn(),
 }));
 
 describe('serverUtils', () => {