このページは英語からの機械翻訳を使用しており、誤りや不明瞭な表現が含まれている可能性があります。最も正確な情報については、オリジナルの英語版をご覧ください。頻繁な更新のため、一部のコンテンツはオリジナルの英語になっている可能性があります。Crowdinでの取り組みに参加して、このページの翻訳改善にご協力ください。 (Crowdin translation page, Contributing guide)

モデルコンテキストプロトコル（MCP）

概要

カイア・エージェント・キットは、いくつかの一般的なAIフレームワークと統合されており、お好みの開発ツールを使ってブロックチェーン対応のエージェントを構築することができます。このガイドでは、モデルコンテキストプロトコル(MCP)サーバーを使用したAIエージェントの作成方法について説明します。このサーバーでは、オンチェーンアクションにKaia Agent Kitを使用し、Claude DesktopなどのMCPホストを使用します。

前提条件

Node.js & pnpm インストール済み
秘密鍵が準備されたカイア・ウォレット
Google Generative APIキー
カイアネットワークのRPCプロバイダー
Kaiascan API Key
クロードデスクトップ

はじめに

このガイドでは、Kaia Agent Kit + MCPホスト（Claude Desktop）を使用して、オンチェーン機能を持つMCPサーバーを使用したAIエージェントを構築します：

ネイティブトークン、ファンジブルトークン（FT）、NFTを送信する。
ネイティブトークン、FT、NFTの残高を確認する。
ブロックチェーンデータを取得 Kaiascan APIは、ネットワークサマリー、カイアの価格、アドレスのトークン残高などを取得します。

AIエージェントスタックを理解する

コードに飛び込む前に、主要なテクノロジーを理解しよう：

**MCPとは？

MCPは、AIシステムがデータソースや外部ツールと相互作用し、必要なデータを提供するための普遍的でオープンな標準である。その中核となるMCPは、ホストアプリケーションが複数のサーバーに接続できるクライアント・サーバー・アーキテクチャを採用している。一方では、MCPサーバーは特定の機能を公開するゲートウェイとして機能する。例えば、標準化されたモデル・コンテキスト・プロトコルを介したブロックチェーン相互作用などであり、他方では、このガイドで使用するMCPホスト（Claude Desktopなど）は、MCPを通じてデータにアクセスするためのツールとして機能する。

さらに、MCPサーバーはクライアント、ホストからの受信要求を処理し、適切な応答データを返す責任を負う。この場合、MCPプロトコルを使って標準的なチャンネル（stdio、HTTP、ソケット）を使ってLLMと通信し、構造化された出力を返す。 MCPプロトコルは拡張できるように設計されており、開発者は新しいツール、リソース、プロンプトをすぐに追加することができます。

このガイドでは、カイア・エージェント・キットを使ってカイア・ブロックチェーンとやりとりするために、MCPサーバー・ツールにオンチェーン機能を追加します。

**カイア・エージェント・キット

一方、カイア・エージェント・キットは、AIエージェントにオンチェーンツールを接続するためのツールで、AIエージェントがカイア・ブロックチェーンとシームレスにやり取りできるようにする。これにより、エージェントはオンチェーンでアクションを実行し、オンチェーン情報を取得し、トランザクションを自律的に検証できるようになる。

プロジェクト設定

新しいプロジェクト・ディレクトリを作成する：


mkdir kaia-agentkit-mcp-example
cd kaia-agentkit-mcp-example

Node.jsプロジェクトを初期化します：


pnpm  init

依存関係をインストールします：


pnpm add @kaiachain/kaia-agent-kit @goat-sdk/adapter-model-context-protocol @goat-sdk/wallet-viem @modelcontextprotocol/sdk dotenv viem


pnpm add -D @types/node typescript

package.jsonを更新し、"type"：type": "module "プロパティと以下のビルドスクリプトを追加して、package.jsonを更新する。


{
  "type": "module",
  "bin": {
    "kaia-mcp": "./build/index.js"
  },
  "scripts": {
    "build": "tsc && chmod 755 build/index.js"
  },
  "files": [
    "build"
  ],
}

プロジェクトのルートにtsconfig.jsonを作成する：


{
  "compilerOptions": {
    "target": "ES2022",
    "module": "Node16",
    "moduleResolution": "Node16",
    "outDir": "./build",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

サーバーの構築

1. index.tsを含むsrcフォルダを作成する。

以下のコードをコピーして、src/index.ts ファイルに貼り付けます：


/*
Imports all the necessary libraries for:
MCP server communication
Blockchain interaction
Connecting MCP to blockchain tools
Specific Kaia blockchain functionality using Kaia Agent Kit
*/
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
import { http, createWalletClient } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { kairos } from "viem/chains";
import { Kaia, PackagesEnum } from '@kaiachain/kaia-agent-kit';
import { getOnChainTools } from "@goat-sdk/adapter-model-context-protocol";
import { viem } from "@goat-sdk/wallet-viem";
// 1. Create the wallet client
const account = privateKeyToAccount(process.env.WALLET_PRIVATE_KEY as `0x${string}`);
const walletClient = createWalletClient({
    account: account,
    transport: http(process.env.RPC_PROVIDER_URL),
    chain: kairos,
});
// 2. Get the onchain tools for the wallet
const toolsPromise = getOnChainTools({
    wallet: viem(walletClient),
    plugins: [Kaia({KAIA_KAIASCAN_API_KEY: process.env.KAIASCAN_API_KEY, packages: []})]
});
// 3. Create and configure the server
const server = new Server(
    {
        name: "kaia-mcp",
        version: "1.0.0",
    },
    {
        capabilities: {
            tools: {},
        },
    },
);
/* 
This section lists two handlers:
List Tools Handler: Responds with all available blockchain tools when an AI asks what tools are available
Call Tool Handler: Executes a specific blockchain tool when requested, passing the appropriate arguments and handling any errors
*/
server.setRequestHandler(ListToolsRequestSchema, async () => {
    const { listOfTools } = await toolsPromise;
    return {
        tools: listOfTools(),
    };
});
server.setRequestHandler(CallToolRequestSchema, async (request) => {
    const { toolHandler } = await toolsPromise;
    try {
        return toolHandler(request.params.name, request.params.arguments);
    } catch (error) {
        throw new Error(`Tool ${request.params.name} failed: ${error}`);
    }
});
// 4. Start the server
async function main() {
    const transport = new StdioServerTransport();
    await server.connect(transport);
    console.error("KAIA MCP Server running on stdio");
}
main().catch((error) => {
    console.error("Fatal error in main():", error);
    process.exit(1);
});

このコードでは、AIシステムがウォレットクライアントをセットアップし、アダプタとKaiaエージェントキットを介してブロックチェーンツールを取得し、標準的な入出力通信チャネルを介して利用可能なツールの一覧表示とブロックチェーン操作の実行要求を処理することで、Kaiaブロックチェーンと対話できるようにするモデルコンテキストプロトコル（MCP）サーバーを作成します。

**2. ビルド・プロジェクト

以下のコマンドでサーバーをビルドしてください：


pnpm build

これはコンパイルされたindex.jsファイルを含むbuild/ディレクトリを生成する。

3. クロードデスクトップの設定

使用するMCPサーバー用にClaude for Desktopを設定する必要があります。これを行うには、テキストエディタで ~/Library/Application Support/Claude/claude_desktop_config.json にあるデスクトップアプリ設定のクロードを開きます。

以下のコマンドを実行して、claude_desktop_config.jsonファイルを開きます：


code ~/Library/Application\ Support/Claude/claude_desktop_config.json

その後、mcpServersキーにサーバーを追加する。この場合、以下のようにkaia-agentサーバーを追加する：


{
    "mcpServers": {
        "kaia-agent": {
            "command": "node",
            "args": ["/ABSOLUTE/PATH/TO/PARENT/model-context-protocol/build/index.js"],
            "env": {
                "WALLET_PRIVATE_KEY": "PASTE_PRIVATE_KEY",
                "RPC_PROVIDER_URL": "PASTE_RPC_PROVIDER_URL",
                "KAIASCAN_API_KEY": "PASTE_KAIASCAN_API_KEY"
            }
        }
    }
}

wallet-private-key**をあなたのWallet秘密鍵に置き換えてください。
rpc-provider-url**をRPCプロバイダのURLに置き換えてください。
kaiascan-api-key**をあなたのKaiascan API Keyに置き換えてください。
absolute-path-to**をプロジェクト・ディレクトリの絶対パスに置き換えてください（例：/Users/username/ai-agent/mcp/kaia-agentkit-mcp-example/build/index.js）。

ファイルを保存し、クロードデスクトップを再起動します。 MCPサーバーのツールは、クロード・デスクトップ

Claude for Desktopでサーバーをテストする

AIエージェントと対話し、カイアのオンチェーン・アクションを実行できるようになりました：


What is the current  Kaia balance of 0x75Bc50a5664657c869Edc0E058d192EeEfD570eb on kairos? Please answer in KAIA and its total value in USD.
Check Kaia current price ?
Send test KAIA to this address: 0x75Bc50a5664657c869Edc0E058d192EeEfD570eb

出力

概要​

前提条件​

はじめに​

AIエージェントスタックを理解する​

プロジェクト設定​

サーバーの構築​

Claude for Desktopでサーバーをテストする​

その他のリソース​

概要