フラックス

MCP サーバーを使用して既存のツールおよびエディターと統合する、強化された AI ベースの AO ツール呼び出し。

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

実装された機能

自然言語のみを使用してAOコードを実行する
自然言語のみを使用してカスタム AO コード/ブループリントを作成し、実行する
Cursor、Windsurf、Claude などの既存の AI 開発ツールや、MCP ツール呼び出しをサポートするあらゆるツールと統合します。
プロセスにプッシュするすべてのコードをテストできる
複雑なハンドラーを作成しテストできる

Related MCP server: AVA MCP Server

実装される機能

AOエコシステムツールとの統合
AOに関するコンテキストを追加することでコード生成機能が向上します

技術スタック

AO
アーウィーブ
MCP タイプスクリプト SDK
タイプスクリプト
Node.js

インストール

現在、Flux をインストールして使用する方法は 2 つあります。現時点では Cursor でのみ十分にテストされているため、Cursor で Flux をインストールする方法を紹介します。

ローカルセットアップ - リモートサーバーを介さずにすべてをローカルに置きたいユーザー向け
- NODE.js の最新の安定バージョンがインストールされていることを確認してください - Node.js のダウンロード
- カーソルを開き、 「設定」 > 「カーソル設定」 > 「MCP」 > **「新しいMCPツールの追加」**に進みます。
- このコードをファイルに貼り付けます
  "mcpServers": { "flux": { "command": "npx", "args": ["-y", "flux-ao@latest"], } }
- すべてを正しく実行すると、すべてのツールがロードされた Flux MCP が表示され、Cursor で使用できるようになります (PS: MCP を複数回リロードするか、Cursor を再起動する必要がある場合があります)。
リモートセットアップ - ローカルに何もインストールせずに Flux を使用したいユーザー向け
- カーソルを開き、 「設定」 > 「カーソル設定」 > 「MCP」 > **「新しいMCPツールの追加」**に進みます。
- このコードをファイルに貼り付けます
  "mcpServers": { "flux": { "url": "https://flux-2esw.onrender.com/sse", } }
- すべてを正しく実行すると、すべてのツールがロードされた Flux MCP が表示され、Cursor で使用できるようになります (PS: MCP を複数回リロードするか、Cursor を再起動する必要がある場合があります)。

使用法

MCPサーバーの使用を開始する前に、AOドキュメント用のllms.txtカーソルに追加し、コンテキストとして使用することをお勧めします。方法がわからない場合は、カーソルにドキュメントを追加する方法に関するこちらのドキュメントをご覧ください。

カーソルに与えるコンテキストが多ければ多いほど、応答はより正確になります。

カーソルが幻覚を起こしたり誤った反応をしたりしないように、カーソルプロジェクトに以下のカスタムルールを追加してください。これらのルールは、 「設定」 > 「カーソル設定」 > 「ルール」 > **「新しいルールを追加」**から追加できます。

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
    )

これで、Cursor Agents で Flux MCP サーバーの使用を開始できます。