Flux

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 -

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）！

使用方法

建议先将 AO 文档的 llms.txt 添加到 Cursor 中，并在开始使用 MCP 服务之前将其作为上下文。如果你不知道如何操作，请查看此文档，了解如何将文档添加到 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] 告知我们。