OOMOL CONNECT

Provides MCP integration for Oomol Connect, enabling blocks, tasks, and package management via MCP clients.

typescript

0

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "oomol-lab-oomol-connect-mcp-sdk-ts": {
      "command": "npx",
      "args": [
        "-y",
        "oomol-connect-mcp-sdk-ts"
      ],
      "env": {
        "OOMOL_CONNECT_BASE_URL": "http://localhost:3000/api",
        "OOMOL_CONNECT_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

You can integrate Oomol Connect with MCP-compatible clients to access and automate Oomol’s block-based functionality. This MCP server enables you to run the Oomol Connect MCP SDK locally or remotely, exposing a standardized interface for listing blocks, executing tasks, and managing packages with real-time progress and intelligent polling.

How to use

Connect your MCP client (such as Cherry Studio, Claude Desktop, or VSCode) to the Oomol Connect MCP server to list available blocks, run tasks, and monitor progress. You have two primary ways to connect: a remote HTTP endpoint or a local stdio process started via a command like npx. Choose the method that suits your workflow and ensure your client is configured with the correct base URL and API token.

How to install

Prerequisites: Node.js and npm must be installed on your system. You also need a running API endpoint you can reach from the MCP client (base URL) and an API token for authentication.

Install the MCP SDK globally or use npx for quick start.

Configuration

Set the required environment variables for your MCP server connection. You will typically configure the API base URL and API token, plus optional defaults to control timeouts.

# Required
export OOMOL_CONNECT_BASE_URL="http://localhost:3000/api"
export OOMOL_CONNECT_API_TOKEN="api-your-token-here"

# Optional
export OOMOL_CONNECT_DEFAULT_TIMEOUT="300000"

Programmatic usage

You can instantiate and run the MCP server client programmatically in TypeScript to integrate into your own tooling or automation flows.

import { OomolConnectMcpServer } from "oomol-connect-mcp-sdk-ts";

const server = new OomolConnectMcpServer({
  baseUrl: "http://localhost:3000/api",
  authHeader: "Bearer your-token",
  name: "my-server",
  version: "1.0.0",
});

await server.run();

Development

If you contribute or customize the SDK, you can install dependencies, build, and run in development mode. This enables you to test changes against a local MCP environment.

# Install dependencies
npm install

# Build
npm run build

# Development mode (watch)
npm run dev

# Run locally
npm start

Available tools

list_blocks

List all available blocks, returning the latest version by default and an option to include all versions.

list_tasks

List historical task executions to review past activity.

execute_task

Run a task and wait for its completion, suitable for common use cases.

execute_task_with_files

Run a task while uploading files as inputs.

list_packages

List installed packages within the server context.

install_package

Install a package and wait for completion.

create_task

Create a task asynchronously without waiting for results.

get_task

Query the status of a previously created task.

stop_task

Stop a running task.