npm package: @seliseblocks/mcp-server
Description: A Model Context Protocol (MCP) server for managing schemas in SELISE Blocks platform, built with TypeScript.
Author: SELISE Blocks
Latest version: 0.0.15

# 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

```bash
# Install dependencies
npm install

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

### Building and Running

```bash
# 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:

```json
{
  "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.