MCP 服务器

Snak

构建由 Starknet 驱动的强大且安全的 AI 代理。

README

<h1>Snak (alpha)</h1>

一个用于创建可以与 Starknet 区块链交互的 AI 代理的工具包。可以作为 NPM 包和带有 Web 界面的即用型 NestJS 服务器使用。支持包括 Anthropic、OpenAI、Google Gemini 和 Ollama 在内的多个 AI 提供商。

快速开始

前提条件

Starknet 钱包（推荐：Argent X）
AI 提供商 API 密钥 (Anthropic/OpenAI/Google Gemini/Ollama)
已安装 Node.js 和 pnpm

安装

git clone https://github.com/kasarlabs/snak.git
cd snak
pnpm install

配置

创建一个 .env 文件：

# Starknet 配置（强制）
STARKNET_PUBLIC_ADDRESS="YOUR_STARKNET_PUBLIC_ADDRESS"
STARKNET_PRIVATE_KEY="YOUR_STARKNET_PRIVATE_KEY"
STARKNET_RPC_URL="YOUR_STARKNET_RPC_URL"

# AI 提供商配置（强制）
AI_PROVIDER_API_KEY="YOUR_AI_PROVIDER_API_KEY"
AI_MODEL="YOUR_AI_MODEL"
AI_PROVIDER="YOUR_AI_PROVIDER"

# NestJS 服务器配置
SERVER_API_KEY="YOUR_SERVER_API_KEY"
SERVER_PORT="YOUR_SERVER_PORT"

#Node Configuration # optional by default : production 
NODE_ENV="YOUR_NODE_ENV"
# Agent additional configuration

POSTGRES_USER="YOUR_POSTGRES_USER"
POSTGRES_PASSWORD="YOUR_POSTGRES_PASSWORD"
POSTGRES_ROOT_DB="YOUR_POSTGRES_ROOT_DB"
POSTGRES_HOST="YOUR_POSTGRES_HOST"
POSTGRES_PORT="YOUR_POSTGRES_PORT"

创建你的 agent.config.json

{
  "name": "Your Agent name",
  "bio": "Your AI Agent Bio",
  "lore": ["Some lore of your AI Agent 1", "Some lore of your AI Agent 1"],
  "objectives": [
    "first objective that your AI Agent need to follow",
    "second objective that your AI Agent need to follow"
  ],
  "knowledge": [
    "first knowledge of your AI Agent",
    "second knowledge of your AI Agent"
  ],
  "interval": "Your agent interval beetween each transaction of the Agent in ms,",
  "chat_id": "Your Agent Chat-id for isolating memory",  
  "autonomous" : "Your agent is autonomous or not",
  "mcp": "Your agent can use mcp or not",
  "internal_plugins": [
    "Your first internal plugin",
    "Your second internal plugin"
  ],
  "external_plugins": [
    "Your first external plugin",
    "Your second external plugin"
  ]
}

您可以使用我们的工具在 starkagent 上轻松创建自己的代理配置

用法

提示模式

运行提示：

# 从 default.agent.json 开始
pnpm run start

# 从您的自定义配置开始
pnpm run start --agent="name_of_your_config.json"

服务器模式

运行服务器：

# 从 default.agent.json 开始
pnpm run start:server

# 从您的自定义配置开始
pnpm run start:server --agent="name_of_your_config.json"

可用模式

	交互模式	自主模式
提示模式	✅	✅
服务器模式	✅	❌

在您的项目中实施 Snak

安装 snak 包

#using npm
npm install @starknet-agent-kit

# using pnpm 
pnpm add @starknet-agent-kit

创建您的代理实例

import { StarknetAgent } from 'starknet-agent-kit';

const agent = new StarknetAgent({
  provider: new RpcProvider({ nodeUrl: process.env.STARKNET_RPC_URL }),
  accountPrivateKey: process.env.STARKNET_PRIVATE_KEY,
  accountPublicKey: process.env.STARKNET_PUBLIC_ADDRESS,
  aiModel: process.env.AI_MODEL,
  aiProvider: process.env.AI_PROVIDER,
  aiProviderApiKey: process.env.AI_PROVIDER_API_KEY,
  signature: 'key',
  agentMode: 'auto',
  agentconfig: y,
});

const response = await agent.execute("What's my ETH balance?");