Labsco
hugobiais logo

Wordware

from hugobiais

Run your Wordware apps locally with an interactive setup.

🔥🔥🔥✓ VerifiedAccount requiredAdvanced setup
#automation#devops#git

wordware-mcp

The Wordware MCP (Model Context Protocol) server allows you to run your Wordware apps locally. This enables you to integrate Wordware's powerful AI flows directly into your local development environment, making it easier to test and develop applications that leverage Wordware's capabilities.

What's New in Version 1.1.5

  • Updated to work with the new local API endpoint (http://localhost:9000/{WORDWARE_API_TOKEN})
  • No need to specify APP_IDs anymore - tools are discovered automatically
  • Interactive installation process with npx wordware-mcp
  • Automatic Claude configuration setup
  • Enhanced CLI interface with command-line argument support
  • Direct specification of API key via parameters
  • Improved error handling and logging
  • Global installation support with simple command syntax

Using with Claude Desktop

To use this MCP server with Claude Desktop:

  1. Make sure Claude for Desktop is installed

  2. Modify the Claude desktop config file located at: ~/Library/Application\ Support/Claude/claude_desktop_config.json

  3. Add the following to the file:

{
  "mcpServers": {
    "wordware": {
      "command": "wordware-mcp"
    }
  }
}

Complete Example Workflow

Here's a complete workflow example to get up and running quickly:

1. Configure and Start Wordware MCP

# Run the interactive setup
npx wordware-mcp

# Follow the prompts to:
# - Enter your Wordware API key
# - Configure Claude integration (if desired)

# Once configured, start the server
npx wordware-mcp start

2. Integrate with Your Application

After starting the MCP server, your Wordware apps will be accessible at:

http://localhost:3000/api/run/{app_id}

You can trigger your Wordware flows via HTTP requests:

// Example: Calling your Wordware app from JavaScript
async function callWordwareApp() {
  const response = await fetch("http://localhost:3000/api/run/your-app-id", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      // Your input data here
      prompt: "Your prompt to the AI model",
      // Any other parameters your Wordware app expects
    }),
  });

  const result = await response.json();
  console.log(result);
}

3. Developing with Hot Reloading

During development, any changes you make to your Wordware apps will be immediately available - just refresh your app or make a new API call.

Development

If you want to contribute to this package:

# Clone the repository
git clone https://github.com/yuhuangou/wordware-mcp.git
cd wordware-mcp

# Install dependencies
npm install

# Build the package
npm run build

# Run in development mode
npm run dev

Environment Variables

The following environment variables can be set in the .env file:

  • PORT - The port to run the server on (default: 3000)
  • WORDWARE_API_KEY - Your Wordware API key