使用说明

项目简介

Formicaio是一个直观的应用程序，旨在帮助用户在Autonomi去中心化网络上运行和管理节点。它通过一个基于Model Context Protocol (MCP) 的服务器，将节点管理功能暴露给AI代理，实现自动化操作和智能交互。

主要功能点

节点管理：通过图形用户界面（GUI）或命令行界面（CLI）轻松创建、启动、停止、回收、移除和升级Autonomi网络节点。
实时监控：提供每个节点的奖励余额、内存/CPU使用率、存储记录、对等连接等实时数据和详细图表。
自定义设置：灵活配置节点自动升级、监控频率、L2网络RPC URL、ERC20代币合约地址等。
AI代理集成（MCP服务器）：Formicaio的核心功能之一。它允许AI代理通过JSON-RPC协议调用Formicaio提供的工具，实现对节点行为的自动化和智能化控制，例如根据CPU使用率自动增减节点。
多平台部署：支持作为原生可执行文件、UmbrelOS、CasaOS、Docker和Podman部署。
LCD显示支持：在树莓派上运行时，可连接外部LCD显示屏实时显示节点统计信息。

安装步骤

Formicaio提供了多种安装方式。以下是最常见的原生可执行文件安装方式：

下载可执行文件：
- 请从Formicaio GitHub仓库的最新发布页面下载适用于您操作系统的软件包（支持Linux, Windows, macOS）。
- 将下载的压缩包解压到您选择的目录。
启动后端服务：
- 打开终端（Linux/macOS）或命令提示符（Windows），导航到解压后的Formicaio目录。
- 运行以下命令启动Formicaio后端应用程序：
```
# Linux/macOS
./formicaio start

# Windows
formicaio.exe start
```
- 启动后，Formicaio会自动下载最新的Autonomi节点二进制文件。一旦准备就绪，GUI前端将可在您的浏览器中通过 'http://localhost:52100' 访问。

服务器配置

MCP服务器是Formicaio的一个内置功能，用于与MCP客户端（例如AI代理）通信。以下是配置MCP服务器的说明：

启动MCP服务器：在启动Formicaio后端时，通过添加 '--mcp' 参数来启用MCP服务器。它将在默认地址 '127.0.0.1:52105' 上监听请求。

# Linux/macOS
./formicaio start --mcp

# Windows
formicaio.exe start --mcp

自定义MCP服务器地址和端口：如果您需要指定MCP服务器监听的IP地址和端口，可以使用 '--mcp-addr <IP>:<port>' 参数：

# Linux/macOS
./formicaio start --mcp --mcp-addr <IP>:<port>

# Windows
formicaio.exe start --mcp --mcp-addr <IP>:<port>

例如，要在所有网络接口上监听 '52105' 端口： './formicaio start --mcp --mcp-addr 0.0.0.0:52105'

MCP客户端配置示例（JSON格式，供AI代理参考）： MCP客户端（如AI代理）需要以下信息来连接Formicaio的MCP服务器：

{
  "server_name": "Formicaio MCP Server SSE",
  "command": "/path/to/formicaio", 
  "args": [
    "start",
    "--mcp",
    "--mcp-addr", "127.0.0.1:52105" 
  ],
  "description": "Formicaio MCP服务器提供Autonomi节点管理工具，用于AI代理的自动化和智能交互。",
  "capabilities": {
    "tools": {
      "list_changed": null
    }
  },
  "protocol_version": "1.0.0",
  "instructions": "Formicaio MCP Server - Use 'ListTools' to discover available node management tools. Connect via HTTP SSE or standard MCP protocols."
}

参数注释：

'server_name': MCP服务器的名称，例如 "Formicaio MCP Server SSE"。
'command': Formicaio可执行文件的完整路径。例如：'/usr/local/bin/formicaio'。
'args': 启动MCP服务器所需的命令行参数列表。'"start"' 启动后端，'"--mcp"' 启用MCP功能，'"--mcp-addr", "127.0.0.1:52105"' 指定MCP服务器的监听地址和端口（请根据您的实际部署调整）。
'description': 服务器的简要描述。
'capabilities': 服务器支持的功能声明，'"tools"' 表示支持工具列表功能。
'protocol_version': MCP协议的版本，通常为 '"1.0.0"'。
'instructions': 客户端可以遵循的额外说明，例如如何发现工具。

基本使用方法

启动Formicaio后端和MCP服务器：按照上述“服务器配置”中的说明，使用 '--mcp' （和可选的 '--mcp-addr'）参数启动Formicaio后端。
连接AI代理：配置您的AI代理（例如n8n、LangChain应用等），使其通过MCP协议连接到Formicaio MCP服务器的指定地址和端口。AI代理将使用上述JSON配置信息来建立连接。
发现和调用工具： AI代理可以通过发送 'ListToolsRequest' 请求来发现Formicaio提供的所有节点管理工具（例如 'create_node_instance', 'start_node_instance', 'fetch_stats' 等）。 AI代理然后可以根据其需求，通过发送 'CallToolRequest' 请求来调用这些工具，实现自动化管理。例如，AI代理可以调用 'fetch_stats' 来获取节点运行统计，或调用 'create_node_instance' 来部署新节点。

关键词