refactor: rename to mountAiMcpServer

Author: Vincent Molinié

packages/agent/src/agent.ts

@@ -200,9 +200,9 @@ export default class Agent<S extends TSchema = TSchema> extends FrameworkMounter
    * This allows AI assistants to interact with your Forest Admin data.
    *
    * @example
-   * agent.mountMcpServer();
+   * agent.mountAiMcpServer();
    */
-  mountMcpServer(): this {
+  mountAiMcpServer(): this {
     this.mcpEnabled = true;
 
     return this;
@@ -225,7 +225,7 @@ export default class Agent<S extends TSchema = TSchema> extends FrameworkMounter
 
     await Promise.all(routes.map(route => route.bootstrap()));
 
-    // Initialize MCP server if enabled via mountMcpServer()
+    // Initialize MCP server if enabled via mountAiMcpServer()
     let mcpHttpCallback: HttpCallback | undefined;
 
     if (this.mcpEnabled) {
@@ -253,7 +253,7 @@ export default class Agent<S extends TSchema = TSchema> extends FrameworkMounter
    */
   private async initializeMcpServer(): Promise<HttpCallback> {
     try {
-      // Dynamic import to defer loading until mountMcpServer() is actually used
+      // Dynamic import to defer loading until mountAiMcpServer() is actually used
       // This avoids loading the transitive dependency @forestadmin-experimental/agent-nodejs-testing
       // at startup for users who don't use MCP
       const { ForestMCPServer } = await import('@forestadmin/mcp-server');
@@ -265,7 +265,6 @@ export default class Agent<S extends TSchema = TSchema> extends FrameworkMounter
         logger: this.options.logger,
       });
 
-      // baseUrl will be automatically fetched from Forest Admin API (environmentApiEndpoint)
       const httpCallback = await mcpServer.getHttpCallback();
 
       this.options.logger('Info', 'MCP server initialized successfully');

packages/agent/test/agent.test.ts

@@ -336,7 +336,7 @@ describe('Agent', () => {
       mockMcpGetHttpCallback.mockResolvedValue(jest.fn());
     });
 
-    test('should not initialize MCP server when mountMcpServer() is not called', async () => {
+    test('should not initialize MCP server when mountAiMcpServer() is not called', async () => {
       const options = factories.forestAdminHttpDriverOptions.build();
       const agent = new Agent(options);
 
@@ -349,21 +349,21 @@ describe('Agent', () => {
       expect(mockMcpGetHttpCallback).not.toHaveBeenCalled();
     });
 
-    test('mountMcpServer() should return this for chaining', () => {
+    test('mountAiMcpServer() should return this for chaining', () => {
       const options = factories.forestAdminHttpDriverOptions.build();
       const agent = new Agent(options);
 
-      const result = agent.mountMcpServer();
+      const result = agent.mountAiMcpServer();
 
       expect(result).toBe(agent);
     });
 
-    test('should initialize MCP server when mountMcpServer() is called', async () => {
+    test('should initialize MCP server when mountAiMcpServer() is called', async () => {
       const mockLogger = jest.fn();
       const options = factories.forestAdminHttpDriverOptions.build({ logger: mockLogger });
       const agent = new Agent(options);
 
-      agent.mountMcpServer();
+      agent.mountAiMcpServer();
       await agent.start();
 
       expect(mockMcpGetHttpCallback).toHaveBeenCalled();
@@ -377,7 +377,7 @@ describe('Agent', () => {
 
       mockMcpGetHttpCallback.mockRejectedValue(new Error('MCP init failed'));
 
-      agent.mountMcpServer();
+      agent.mountAiMcpServer();
 
       await expect(agent.start()).rejects.toThrow('MCP init failed');
 

packages/mcp-server/README.md

@@ -10,14 +10,14 @@ This MCP server provides HTTP REST API access to Forest Admin operations, enabli
 
 ### With Forest Admin Agent
 
-The MCP server is included with the Forest Admin agent. Simply call `mountMcpServer()`:
+The MCP server is included with the Forest Admin agent. Simply call `mountAiMcpServer()`:
 
 ```typescript
 import { createAgent } from '@forestadmin/agent';
 
 const agent = createAgent(options)
   .addDataSource(myDataSource)
-  .mountMcpServer();
+  .mountAiMcpServer();
 
 agent.mountOnExpress(app);
 agent.start();