Flux

by asrvd
834,631
3

Integrations

  • Supports running Lua code in AO processes through the MCP server, enabling handler creation and management.

  • Enables running AO code and blueprints through natural language commands, supporting code testing and complex handler creation.

  • Offers a remote setup option through Render's hosting platform, allowing users to use Flux without local installation.

Flux

AI based AO tool calling on steroids that integrates with your existing tools and editor using a MCP server.

https://github.com/user-attachments/assets/3484e2db-e7cb-479a-84a2-0b399e1149ac

Features Implemented

  • Run AO code using just natural language
  • Create and run custom AO code/blueprints completely using natural language
  • Integrates with your existing AI dev tools like Cursor, Windsurf, Claude, and anything that supports MCP tool calling
  • Can test out all the code it pushes to an process
  • Can create and test complex handlers

Features to be implemented

  • Inetgration with AO ecosystem tools
  • Better code generation capabilities by adding more context about AO

Tech stack

  • AO
  • Arweave
  • MCP typescript sdk
  • Typescript
  • Node.js

Installation

There are currently two ways to install and use Flux, right now it has been tested significantly only on Cursor so we will be showing how to install FLux in Cursor -

  1. Local Setup - For users who want everything to be present locally, no remote servers involved
    • Make sure you have latest stable version of NODE.js installed - Node.js download
    • Copy the content of the file local/index.js to your local machine in any folder and copy the absolute path
    • Open Cursor and go to Settings > Cursor Settings > MCP > Add new MCP tool
    • Paste this code in the file
      "mcpServers": { "flux": { "command": "node /path/to/your/local/index.js", } }
    • if you did everything correctly you will be able to see the flux MCP loaded with all the tools, and its ready to be used in Cursor!
  2. Remote Setup - For users who want to use Flux without installing anything locally
    • Open Cursor and go to Settings > Cursor Settings > MCP > Add new MCP tool
    • Paste this code in the file
      "mcpServers": { "flux": { "url": "https://flux-2esw.onrender.com/sse", } }
    • if you did everything correctly you will be able to see the flux MCP loaded with all the tools, and its ready to be used in Cursor!

Usage

We would suggest you add the llms.txt for AO docs in cursor first and use it as a context before you start using the MCP server. If you don't know how to do it, checkoout this documentation on how to add docs to cursor.

The more context you give to cursor, the more acurate the responses will be.

Now add these custom rules in your Cursor project to make sure Cursor doesn't hallucinate or give wrong responses. You can add these rules in the Settings > Cursor Settings > Rules > Add new rule.

For adding json capabilities ONLY IF NEEDED, you need to add a line "local json = require("json")" on top of file. BUT DONT USE IT UNLESS NEEDED. SIMPLE THINGS CAN BE DONE USING AO PROCESS STATE Always use Send instead of msg.reply Always make sure a handler is sending out a response/reply (using Send) and send it as data as well instaed of just returning using tags Never add any tags by yourself, always add tags when needed or instructed by user, also {"Action":"Eval"} tag is for running lua in an ao process and {"Action" : "action_name"} is for running a handler Never add the "Type" tag to anything, thats reserved for internal ao specifications Always use Handler.utils whever possible when creating a handler, for example -- Handlers.add( "pingpong", Handlers.utils.hasMatchingTag("Action", "Ping"), function (msg) Handlers.utils.reply("Pong")(msg) -- or use Send() here end )

Now you can start using the Flux MCP server in Cursor Agents.

Support

If you find any issues with the Server or encounter any bugs, please let us know by opening an issue or mailing us @ flux.mcp@gamil.com

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

An AI-powered MCP server that enables natural language interaction with AO (Arweave Operating system) for creating, running, and testing code and handlers without manual coding.

  1. Features Implemented
    1. Features to be implemented
      1. Tech stack
        1. Installation
          1. Usage
            1. Support

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                An MCP (Model Context Protocol) server that integrates with the ArgoCD API, enabling AI assistants and large language models to manage ArgoCD applications and resources through natural language interactions.
                Last updated -
                10
                6
                Python
                MIT License
                • Linux
                • Apple
              • -
                security
                A
                license
                -
                quality
                An MCP server that analyzes codebases and generates contextual prompts, making it easier for AI assistants to understand and work with code repositories.
                Last updated -
                2
                Python
                MIT License
              • -
                security
                A
                license
                -
                quality
                An MCP server that enables AI assistants to control a web browser through natural language commands, allowing them to navigate websites and extract information via SSE transport.
                Last updated -
                387
                Python
                MIT License
                • Apple
              • A
                security
                A
                license
                A
                quality
                An MCP server that supercharges AI assistants with powerful tools for software development, enabling research, planning, code generation, and project scaffolding through natural language interaction.
                Last updated -
                11
                6
                TypeScript
                MIT License
                • Linux
                • Apple

              View all related MCP servers

              ID: 74rb54w5bs