フラックス
MCP サーバーを使用して既存のツールおよびエディターと統合する、強化された AI ベースの AO ツール呼び出し。
https://github.com/user-attachments/assets/3484e2db-e7cb-479a-84a2-0b399e1149ac
実装された機能
- 自然言語のみを使用してAOコードを実行する
- 自然言語のみを使用してカスタム AO コード/ブループリントを作成し、実行する
- Cursor、Windsurf、Claude などの既存の AI 開発ツールや、MCP ツール呼び出しをサポートするあらゆるツールと統合します。
- プロセスにプッシュするすべてのコードをテストできる
- 複雑なハンドラーを作成しテストできる
実装される機能
- 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 サーバーの使用を開始できます。
サポート
サーバーに問題が見つかった場合やバグが発生した場合は、問題を報告していただくか、 flux.mcp @gmail.com までメールでご連絡ください。