Ic Agent MCP Example

ic代理mcp模板

概述

用于构建通过模型上下文协议与人工智能助手无缝集成的互联网计算机（IC）代理的模板(主控程序).此模板使您能够将智能合约（容器）部署到IC，并通过MCP将其功能作为AI工具公开。

项目结构

src/
├── agents/                 # Agents as IC canisters, accessible through MCP
└── mcp-server/             # MCP integration

先决条件

• 可制造性 （IC-SDK）
• 锈 随着 wasm32-unknown-unknown 目标
• （适用于MCP服务器）
• 仅仅 （命令运行器）

快速启动

构建和启动代理

1. 安装依赖项：

   just install

1. 启动本地IC副本：

   just start-dfx

1. 部署代理：

   just deploy

1. 生成MCP工具：

   just regen-mcp

将MCP集成到克劳德桌面

要将MCP服务器与Claude Desktop集成，请执行以下操作：

1. 找到您的Claude Desktop配置文件：

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json

1. 添加MCP服务器配置 到 mcpServers 章节：

{
  "mcpServers": {
    "ic-agent": {
      "command": "node",
      "args": ["path-to-your-project/src/mcp-server/server.js"],
      "cwd": "path-to-your-project/src/mcp-server"
    }
  }
}

1. 更新 args 和 cwd 路径 指向你的实际 src/mcp-server 目录

1. 重新启动克劳德桌面 使更改生效

配置后，您将可以直接在Claude Desktop对话中访问所有代理工具。

示例

试着问克劳德： *“增加值，并告诉我之前和之后的值是什么”* -它将自动呼叫您部署的IC代理！

Claude Integration

添加新代理

1. 编写新的容器

   cp -r src/agents/adder src/agents/my_agent
   cd src/agents/my_agent

1. 更新关键文件：

- src/lib.rs：实现代理逻辑 - src/service.did：定义您的Candid界面

   service my_agent: {
       my_function: (text) -> (text) query;
   }

1. 在工作区注册 (Cargo.toml):

   members = [
       "src/agents/adder",
       "src/agents/my_agent",  # Add this
   ]

1. 添加到IC配置 (dfx.json):

   "canisters": {
       "my_agent": {
           "type": "custom",
           "build": "just build",
           "wasm": "target/wasm32-unknown-unknown/release/my_agent.wasm",
           "candid": "src/agents/my_agent/src/service.did"
       }
   }

1. 向MCP注册 (src/mcp-server/agents.json):

   {
       "my_agent": {
           "name": "My Agent",
           "candid_file": "src/agents/my_agent/src/service.did",
           "principal": "your-canister-id"
       }
   }

1. 生成工具并部署容器（代理）：

   just regen-mcp
   just deploy

1. 重新启动Claude（或任何其他MCP集成）

MCP集成

MCP服务器会自动从代理的Candid界面生成AI工具。每个公共函数都成为Claude Desktop中的可调用工具。

有关MCP服务器的详细文档，请参阅 src/mcp-server/README.md.