Icarus SDK：构建持久化AI工具

Icarus SDK 是一个创新的开发工具包，允许开发者在 Internet Computer (ICP) 区块链上构建与大语言模型 (LLM) 兼容的持久化 AI 工具。它结合了 Model Context Protocol (MCP) 的标准，使得 AI 工具具备永不丢失状态、全球可访问、内置安全和低成本运行的特点。通过 Icarus，您可以为 Claude Desktop 等 LLM 客户端创建功能强大、可扩展且具备记忆能力的上下文服务。

主要功能点

持久化状态: AI 工具部署在区块链上，状态数据永久存储，不受服务器重启影响。
MCP 兼容性: 遵循 Model Context Protocol 标准，提供工具发现、调用和上下文管理。
工具定义与执行: 通过 Rust 宏 ('#[icarus_tool]') 轻松定义 AI 工具，并将其作为 ICP 智能合约运行。
HTTP 外调: 允许工具安全地访问外部 API，获取实时数据。
自主定时器: 支持在链上调度一次性或周期性任务，实现自动化操作。
内置身份验证: 利用 Internet Identity 提供安全的身份验证和细粒度的访问控制。
命令行工具: 简化项目创建、构建、部署和与 Claude Desktop 集成的流程。

安装步骤

安装 Rust: 访问 rustup.rs 按照指引安装 Rust。
安装 dfx: 访问 Internet Computer 文档安装 dfx CLI 工具，用于与 Internet Computer 交互。

安装 Icarus CLI: 打开终端，运行以下命令：

cargo install icarus-cli

服务器配置

MCP 服务器是部署到 Internet Computer (ICP) 上的智能合约。LLM 客户端（如 Claude Desktop）需要通过 'icarus-cli' 提供的“桥接”功能来与这些服务器通信。以下是为 Claude Desktop 配置 MCP 服务器的 JSON 示例：

{
  "mcpServers": {
    "your-server-name": {
      "command": "/path/to/icarus",
      "args": [
        "bridge",
        "start",
        "--canister-id",
        "YOUR_CANISTER_ID_HERE"
      ],
      "description": "您的MCP服务器描述，例如：提供持久化记忆功能的AI工具"
    }
  }
}

'your-server-name': 为您的MCP服务器在Claude Desktop中显示的名称，例如 'my-ai-memory'。
'command': 指向您系统中 'icarus' CLI 工具的可执行文件路径。例如，在 macOS/Linux 上通常是 '/Users/yourusername/.cargo/bin/icarus'。
'args': 启动 MCP 桥接服务器的参数。
- 'bridge': 指定运行桥接命令。
- 'start': 启动 MCP 服务器实例。
- '--canister-id': 必须是您部署到 Internet Computer 上的服务器（智能合约）的实际 ID。例如 'ryjl3-tyaaa-aaaaa-aaaba-cai'。
- 'description': 描述您MCP服务器的功能，这将显示在Claude Desktop中。

基本使用方法

创建新项目:

icarus new my-ai-tool
cd my-ai-tool

构建项目: 将 Rust 代码编译为 WebAssembly (WASM) 模块。
```
icarus build
```

本地部署 (可选，推荐): 在本地 Internet Computer 环境中部署您的 AI 工具。

dfx start --clean   # 启动本地ICP网络 (如果尚未运行)
icarus deploy --network local # 部署您的AI工具到本地ICP

部署成功后，您将获得一个 'YOUR_CANISTER_ID_HERE'。

连接到 Claude Desktop: 使用您的智能合约 ID 将其添加到 Claude Desktop 配置中。
```
icarus bridge add YOUR_CANISTER_ID_HERE
```
这将自动更新 Claude Desktop 的配置文件。之后，重启 Claude Desktop，您的 Icarus AI 工具将作为可用的 MCP 服务器出现在其工具列表中。

关键词

Icarus SDK：构建持久化AI工具

主要功能点

安装步骤

服务器配置

基本使用方法

信息