io.github.InsForge/insforge-mcp

Official

by InsForge · TypeScript

InsForge

MCP server for InsForge BaaS — database, storage, edge functions, and deployments

Backend-as-a-service with database, storage, edge functions, and deployment management.

</div>

Insforge MCP Server

InsForge turns your coding agents into full-stack builders, letting them add backend features like auth, databases, file storage, serverless functions, and LLMs to your apps in seconds.

This repo is Model Context Protocol server for Insforge.

📖 Documentation

Please visit the main Insforge repository for:

Installation and setup instructions
Configuration guide
Available tools and usage examples
API documentation
Contributing guidelines

🚀 Quick Start

Automated Installation (Recommended)

Use the InsForge installer to automatically configure MCP for your client:

bash

# Claude Code
npx @insforge/install --client claude-code --env API_KEY=your_api_key --env API_BASE_URL=http://localhost:7130

# Cursor
npx @insforge/install --client cursor --env API_KEY=your_api_key --env API_BASE_URL=http://localhost:7130

# Windsurf
npx @insforge/install --client windsurf --env API_KEY=your_api_key --env API_BASE_URL=http://localhost:7130

# Cline
npx @insforge/install --client cline --env API_KEY=your_api_key --env API_BASE_URL=http://localhost:7130

# Roo Code
npx @insforge/install --client roocode --env API_KEY=your_api_key --env API_BASE_URL=http://localhost:7130
# Trae
npx @insforge/install --client trae --env API_KEY=your_api_key --env API_BASE_URL=http://localhost:7130

# Install dev version for testing
npx @insforge/install --client cursor --env API_KEY=your_api_key --env API_BASE_URL=http://localhost:7130 --dev

Replace:

your_api_key with your InsForge API key
http://localhost:7130 with your InsForge instance URL (optional, defaults to localhost:7130)

Manual Installation

If you prefer to manually configure your MCP client, add this to your MCP settings file:

json

{
  "mcpServers": {
    "insforge": {
      "command": "npx",
      "args": [
        "-y",
        "@insforge/mcp@latest"
      ],
      "env": {
        "API_KEY": "your_api_key",
        "API_BASE_URL": "http://localhost:7130"
      }
    }
  }
}

For detailed setup instructions, see the Insforge Documentation.

🛠️ Development

If you are contributing to this project or running it locally:

bash

# Install dependencies
npm install

# Run unit tests
npm run test

# Run linter (static analysis)
npm run lint

# Auto-format code
npm run format

# Build the package
npm run build

📄 License

Apache License 2.0 - see the LICENSE file for details.

Part of the Insforge project.

Install

Configuration

Environment variables

API_KEYrequiredsecret

InsForge project API key

API_BASE_URLrequired

InsForge backend URL (e.g. https://your-app.us-east.insforge.app)

claude_desktop_config.json

{
  "mcpServers": {
    "insforge-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@insforge/mcp@1.2.6"
      ],
      "env": {
        "API_KEY": "<YOUR_API_KEY>",
        "API_BASE_URL": "<YOUR_API_BASE_URL>"
      }
    }
  }
}