Flux

Flux

既存のツールやエディターとMCP サーバーを介して連携する、強化されたAIベースのAOツール呼び出しツールです。

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

実装済みの機能

• 自然言語だけでAOコードを実行
• 自然言語だけでカスタムAOコードやブループリントを作成して実行
• Cursor、Windsurf、Claudeなど、MCPツール呼び出しに対応する既存のAI開発ツールと連携
• processにプッシュするすべてのコードをテスト可能
• 複雑なハンドラーを作成してテスト可能

実装予定の機能

• AOエコシステムのツールとの連携
• AOに関するコンテキストを追加してコード生成機能を改善

技術スタック

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

インストール

Fluxをインストールして使用する方法は現在2つあります。現時点ではCursorでのみ十分なテストを実施しているため、ここではCursorへのFluxのインストール方法を説明します。

1. ローカルセットアップ - すべてをローカルに配置し、リモートサーバーを使わずに利用したい方向け

   • 最新の安定版NODE.jsがインストールされていることを確認してください - Node.jsのダウンロード
   • Cursorを開き、Settings > Cursor Settings > MCP > Add new MCP toolに移動します
   • 次のコードをファイルに貼り付けます

     "mcpServers": {
         "flux": {
             "command": "npx",
             "args": ["-y", "flux-ao@latest"],
         }
     }
     

   • 正しく設定できていれば、すべてのツールとともにFlux MCPが読み込まれ、Cursorですぐに使用できます（注：MCPを複数回再読み込みするか、Cursorを再起動する必要がある場合があります）！

2. リモートセットアップ - ローカルに何もインストールせずにFluxを使いたい方向け

   • Cursorを開き、Settings > Cursor Settings > MCP > Add new MCP toolに移動します
   • 次のコードをファイルに貼り付けます

     "mcpServers": {
         "flux": {
             "url": "https://flux-2esw.onrender.com/sse",
         }
     }
     

   • 正しく設定できていれば、すべてのツールとともにFlux MCPが読み込まれ、Cursorですぐに使用できます（注：MCPを複数回再読み込みするか、Cursorを再起動する必要がある場合があります）！

使い方

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

Cursorに与えるコンテキストが多いほど、回答の精度が高くなります。

次に、Cursorが誤った情報を生成したり、不正確な回答を返したりしないよう、Cursorプロジェクトに次のカスタムルールを追加してください。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
    )

これで、Cursor AgentsでFlux MCP サーバーを使い始めることができます。

サポート

サーバーに問題が見つかった場合やバグに遭遇した場合は、issueを作成するか、[email protected]までメールでお知らせください。