项目介绍
Flux
基于AI的AO工具增强版，通过MCP服务器与现有的工具和编辑器集成。
https://github.com/user-attachments/assets/3484e2db-e7cb-479a-84a2-0b399e1149ac
已实现功能
- 使用自然语言运行AO代码
- 完全使用自然语言创建并运行自定义AO代码/蓝图
- 与现有的AI开发工具（如Cursor、Windsurf、Claude等）集成，支持MCP工具调用
- 可以测试推送到进程的所有代码
- 可以创建和测试复杂的处理器
待实现功能
- 与AO生态系统工具集成
- 通过增加更多关于AO的上下文信息来提高代码生成能力
技术栈
- AO
- Arweave
- MCP TypeScript SDK
- TypeScript
- Node.js
安装
目前有两种方式安装和使用Flux，当前仅在Cursor上进行了大量测试，因此我们将展示如何在Cursor中安装Flux：
-
本地设置 - 对于希望所有内容都保存在本地且不涉及远程服务器的用户
- 确保已安装最新稳定的NODE.js版本 - Node.js下载
- 打开Cursor，进入设置 > Cursor设置 > MCP > 添加新MCP工具
- 将以下代码粘贴到文件中
"mcpServers": { "flux": { "command": "npx", "args": ["-y", "flux-ao@latest"], } } - 如果操作正确，您将在Cursor中看到加载了Flux MCP及其所有工具，并准备好使用（提示：您可能需要多次重新加载MCP或重启Cursor）！
-
远程设置 - 对于希望无需本地安装即可使用Flux的用户
- 打开Cursor，进入设置 > Cursor设置 > MCP > 添加新MCP工具
- 将以下代码粘贴到文件中
"mcpServers": { "flux": { "url": "https://flux-2esw.onrender.com/sse", } } - 如果操作正确，您将在Cursor中看到加载了Flux MCP及其所有工具，并准备好使用（提示：您可能需要多次重新加载MCP或重启Cursor）！
使用方法
我们建议您首先在Cursor中添加llms.txt作为AO文档的上下文，在开始使用MCP服务器之前。如果您不知道如何操作，请参阅此文档了解如何将文档添加到Cursor中。
提供的上下文越多，响应越准确。
现在，在您的Cursor项目中添加这些自定义规则，确保Cursor不会产生幻觉或给出错误的响应。您可以在设置 > Cursor设置 > 规则 > 添加新规则中添加这些规则。
如果需要添加JSON功能，您需要在文件顶部添加一行 "local json = require("json")"。但除非必要，否则不要使用它。简单的事情可以通过AO进程状态完成。
始终使用Send而不是msg.reply
确保处理器发送响应/回复（使用Send），并且将其作为数据发送，而不仅仅是使用标签返回
永远不要自行添加任何标签，只有在需要或用户指示时才添加标签，{"Action":"Eval"}标签用于在ao进程中运行lua，{"Action" : "action_name"}用于运行处理器
永远不要将"Type"标签添加到任何内容中，这是保留给内部ao规范使用的
尽可能地使用Handler.utils创建处理器，例如 --
Handlers.add(
"pingpong",
Handlers.utils.hasMatchingTag("Action", "Ping"),
function (msg)
Handlers.utils.reply("Pong")(msg) -- 或在这里使用Send()
end
)
现在您可以开始在Cursor代理中使用Flux MCP服务器。
支持
如果您发现服务器存在问题或遇到任何bug，请通过打开问题或邮件至flux.mcp@gmail.com告知我们。