l0-node-blocks-mcp

A Model Context Protocol (MCP) server for managing schemas in SELISE Blocks platform, built with TypeScript.

Overview

This project implements an MCP server that provides tools for creating and updating schemas in the SELISE Blocks platform. It uses the Model Context Protocol to expose these capabilities as tools that can be called by MCP clients.

Available Tools

This MCP server provides the following tools:

1. Create Schema

Creates a new schema in the SELISE Blocks platform.

Parameters:

• CollectionName: Name of the collection
• SchemaName: Name of the schema
• SchemaType: Type of the schema (typically 1)
• Fields: Array of field definitions with Name and Type properties
• ProjectKey: Project key for API access

2. Update Schema

Updates an existing schema in the SELISE Blocks platform.

Parameters:

• ItemId: GUID of the item to update
• CollectionName: Name of the collection
• SchemaName: Name of the schema
• SchemaType: Type of the schema (typically 1)
• Fields: Array of field definitions with Name and Type properties
• ProjectKey: Project key for API access

Getting Started

Prerequisites

• Node.js (v20 or higher)
• npm or yarn

Installation

# Install dependencies
npm install

# Install TypeScript dependencies
npm install --save-dev typescript @types/node ts-node

Building and Running

# Build the TypeScript code
npm run build

# Run the server
npm start

MCP Configuration

Setting up MCP in Cursor or Claude

Create or edit the MCP configuration file:

in Cursor

1. Open Cursor settings (Cmd/Ctrl + ,)
2. Search for "MCP" or navigate to Extensions > MCP

in Claude

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the blocks server configuration:

{
  "mcpServers": {
    "blocks-server": {
      "command": "npx",
      "args": ["-y", "@seliseblocks/mcp-server"],
      "env": {
        "BLOCKS_KEY": "blocks-project-key",
        "USERNAME": "your-username",
        "PASSKEY": "your-user-passkey",
        "API_BASE_URL": "https://blocks-api-url"
      }
    }
  }
}

Environment Variables

The following environment variables are required:

• BLOCKS_KEY - Your blocks API key
• USERNAME - Your username
• PASSKEY - Your user key for authentication
• API_BASE_URL - API base url of blocks cloud

You can either set these as system environment variables or include them in the MCP configuration as shown above.

Scripts

• npm run build - Compile TypeScript to JavaScript
• npm run start - Build and run the compiled server
• npm run dev - Run server directly with ts-node (development)
• npm run debug - Build and run with Node.js debugger
• npm run clean - Remove compiled output
• npm run watch - Watch for changes and recompile
• npm run lint - Run ESLint on TypeScript files
• npm run type-check - Type check without compilation

Example: Creating a Schema

You can ask the MCP server to create a schema for you with a prompt like this:

Can you create a schema for me with these details:
- CollectionName: "Products"
- SchemaName: "Products"
- Fields: ItemName (String), Price (Float), Stock (Float)
- ProjectKey: "my-project-123"

License

This project is proprietary and confidential.