@forestadmin/mcp-server

Model Context Protocol (MCP) server for Forest Admin with OAuth authentication support.

Overview

This MCP server provides HTTP REST API access to Forest Admin operations, enabling AI assistants and other MCP clients to interact with your Forest Admin data through a standardized protocol.

Usage

With Forest Admin Agent

The MCP server is included with the Forest Admin agent. Simply call mountAiMcpServer():

import { createAgent } from '@forestadmin/agent';

const agent = createAgent(options)
  .addDataSource(myDataSource)
  .mountAiMcpServer();

agent.mountOnExpress(app);
agent.start();
Copy

The MCP server will be automatically initialized and mounted on your application.

Standalone Server

You can also run the MCP server standalone using the CLI:

npx forest-mcp-server
Copy

Or programmatically:

node dist/index.js
Copy

Environment Variables

The following environment variables are required to run the server as a standalone:

Example Configuration

export FOREST_ENV_SECRET="your-env-secret"
export FOREST_AUTH_SECRET="your-auth-secret"
export MCP_SERVER_PORT=3931

npx forest-mcp-server
Copy

API Endpoint

Once running, the MCP server exposes a single endpoint:

• POST /mcp - Main MCP protocol endpoint

The server expects MCP protocol messages in the request body and returns MCP-formatted responses.

Features

• HTTP Transport: Uses streamable HTTP transport for MCP communication
• OAuth Authentication: Built-in support for Forest Admin OAuth
• CORS Enabled: Allows cross-origin requests
• Express-based: Built on top of Express.js for reliability and extensibility

Development

Building

npm run build
Copy

Watch Mode

npm run build:watch
Copy

Linting

npm run lint
Copy

Testing

npm test
Copy

Cleaning

npm run clean
Copy

Architecture

The server consists of:

• ForestMCPServer: Main server class managing the MCP server lifecycle
• McpServer: Core MCP protocol implementation
• StreamableHTTPServerTransport: HTTP transport layer for MCP
• Express App: HTTP server handling incoming requests

License

GPL-3.0

Repository

https://github.com/ForestAdmin/agent-nodejs

Support

For issues and feature requests, please visit the GitHub repository.