Install Locally

If you prefer to run the MCP server on your own machine, follow these steps.

Prerequisites

First, clone the repository:

git clone https://github.com/Makinari/API.git
cd API

Ensure you have the project dependencies installed.

npm install

Configuration

The MCP server requires the following environment variables:

• MCP_SITE_ID (required): The ID of your site.
• MCP_USER_ID (optional): The ID of the user.
• MCP_INSTANCE_ID (optional): The ID of the instance (default: ‘default’).
• API_URL (optional): API base URL. Local default is http://localhost:3001 (npm run dev in this repo). Hosted: https://backend.makinari.com.
• REST_API_KEY (optional): Required if using a remote API (e.g., Makinari API).
• SERVICE_API_KEY (optional): Required if running the API locally. This should be set in the .env file of the API project.

Running the Server

Stdio Mode

To run the MCP server in stdio mode (for local development or Cursor integration):

npm run mcp

HTTP Mode

The MCP server is also exposed via an HTTP endpoint for remote clients.

POST /api/mcp

This endpoint handles JSON-RPC requests over HTTP.