diff --git a/.gitbook/docs.json b/.gitbook/docs.json index 46996eed..0c21a2cf 100644 --- a/.gitbook/docs.json +++ b/.gitbook/docs.json @@ -1690,6 +1690,30 @@ ] } ] + }, + { + "language": "ja", + "groups": [ + { + "group": "INJECTIVE", + "pages": [ + { + "group": "AI開発者", + "icon": "brain", + "expanded": false, + "pages": [ + "ja/developers-ai/index", + "ja/developers-ai/injective-cli-skill", + "ja/developers-ai/injective-evm-developer-skill", + "ja/developers-ai/injective-mcp-servers-skill", + "ja/developers-ai/injective-trading-skills", + "ja/developers-ai/documentation-mcp", + "ja/developers-ai/mcp" + ] + } + ] + } + ] } ] }, diff --git a/.gitbook/ja/developers-ai/documentation-mcp.mdx b/.gitbook/ja/developers-ai/documentation-mcp.mdx new file mode 100644 index 00000000..aba322b4 --- /dev/null +++ b/.gitbook/ja/developers-ai/documentation-mcp.mdx @@ -0,0 +1,165 @@ +--- +title: Injective Documentation MCP Server +description: Model Context Protocol（MCP）を使用してAIアシスタントをInjectiveドキュメントに接続する +--- + +Injectiveドキュメントは、Claude、Cursor、その他のMCP対応ツールなどのAIアシスタントが +Injectiveドキュメントから**情報を検索・取得**できるModel Context Protocol（MCP）サーバーを提供しています。 + +これはドキュメント検索だけでなく、他のMCP serverやAI agentと**組み合わせて使用**する場合にも有用です。 +例えば、Cursorなどのエージェント開発ツールを接続し、 +このMCP serverを使用してLLMの汎用ソフトウェア作成能力に**Injective固有の知識を追加**することで、 +Injectiveアプリケーションをバイブコーディングできます。 +開発者ツールの設定方法の詳細は以下に記載しています。 + +AIツールにこのMCP serverの使用方法を教えるには、 +[Injective MCP Servers Skill](/developers-ai/injective-mcp-servers-skill)を使用してください。 + +## MCPとは？ + +[MCP](https://modelcontextprotocol.io/introduction)は、AIアシスタントが外部データソースやツールに接続できるようにする**オープンスタンダード**です。 +トレーニングデータのみに頼るのではなく、AIアシスタントはMCPを使用してドキュメントからリアルタイムで +信頼性の高い情報に直接アクセスできます。 + +## なぜInjective Documentation MCP serverを使用するのか？ + +AIアシスタントをInjective MCP serverに接続すると、以下が可能になります： + +- Injectiveドキュメント全体を検索 +- コード例、APIリファレンス、ガイドを検索 +- 最新情報で質問に回答 +- 関連するドキュメントページへの直接リンクを提供 + +これはInjectiveで構築する際に特に有用で、AIが特定のユースケースに適したドキュメントを見つける手助けをします。 + +## MCP serverの詳細 + +| プロパティ | 値 | +|----------|-------| +| Endpoint | `https://docs.injective.network/mcp` | +| Transport | HTTP (Streamable HTTP) | +| 利用可能なツール | `SearchInjectiveDocs` | + +## MCP serverへの接続 + + + + MCP対応クライアントの場合、エンドポイントURLを直接使用します： + + ``` + https://docs.injective.network/mcp + ``` + + サーバーはStreamable HTTPトランスポートを使用しており、ほとんどの最新MCPクライアントでサポートされています。 + + + CursorのSettingsでMCP serverを追加します： + + 1. Cursor Settingsを開く + 2. **Features** → **MCP Servers**に移動 + 3. **Add new MCP server**をクリック + 4. 以下を入力： + - **Name**: `injective-docs` + - **Type**: `command` + - **Command**: `npx mcp-remote https://docs.injective.network/mcp` + + + Claude Desktopの設定ファイルに以下を追加します： + + + + `~/Library/Application Support/Claude/claude_desktop_config.json`を編集： + + ```json + { + "mcpServers": { + "injective-docs": { + "command": "npx", + "args": [ + "mcp-remote", + "https://docs.injective.network/mcp" + ] + } + } + } + ``` + + + `%APPDATA%\Claude\claude_desktop_config.json`を編集： + + ```json + { + "mcpServers": { + "injective-docs": { + "command": "npx", + "args": [ + "mcp-remote", + "https://docs.injective.network/mcp" + ] + } + } + } + ``` + + + + 設定を保存した後、Claude Desktopを再起動してください。Injective Docsツールがclaudeの利用可能なツールに表示されます。 + + + +## MCP serverの使用 + +接続後、AIアシスタントにInjectiveに関する質問をできます。 +アシスタントは自動的に`SearchInjectiveDocs`ツールを使用して関連情報を検索します。 + +**プロンプト例：** + +- 「Injectiveでウォレットを作成するには？」 +- 「CosmWasmスマートコントラクトのデプロイ方法を教えて」 +- 「Injective mainnetのネットワークエンドポイントは？」 +- 「Token Factoryモジュールの使い方は？」 +- 「Injectiveでのマージントレーディングの仕組みを説明して」 + +AIがドキュメントを検索し、関連ページへのリンク付きで回答を提供します。 + +## MCPツールリファレンス + +### `SearchInjectiveDocs` + +Injectiveドキュメント全体を検索して関連情報を見つけます。 + +**パラメーター：** + +| パラメーター | 型 | 必須 | 説明 | +|-----------|------|------|------| +| `query` | string | はい | 関連ドキュメントを検索するための検索クエリ | + +**戻り値：** + +タイトルとドキュメントページへの直接リンクを含むコンテキストコンテンツ。 +このツールはInjectiveドキュメント全体にわたるセマンティック検索を実行し、ページコンテンツ、見出し、コード例に対してクエリをマッチングします。 +結果は関連性でランク付けされ、クエリに最適な抽出スニペットとソースURLが返されます。 + +**例：** + +リクエスト： +```json +{ + "tool": "SearchInjectiveDocs", + "arguments": { + "query": "how to create a token using token factory" + } +} +``` + +レスポンス： +```json +{ + "content": [ + { + "type": "text", + "text": "# Token Factory\n\nThe Token Factory module allows you to create and manage custom tokens on Injective...\n\n## Creating a Token\n\nTo create a new token, use the `tokenfactory/create-denom` message...\n\nSource: https://docs.injective.network/developers/concepts/token-factory" + } + ] +} +``` diff --git a/.gitbook/ja/developers-ai/index.mdx b/.gitbook/ja/developers-ai/index.mdx new file mode 100644 index 00000000..ad0de68c --- /dev/null +++ b/.gitbook/ja/developers-ai/index.mdx @@ -0,0 +1,115 @@ +--- +description: >- + 生成AIソフトウェアエンジニアリングでInjectiveを構築する。 +title: AI開発者 +--- + +## なぜInjectiveで生成AIツールを使って構築するのか？ + +生成AIコーディングツールを使用すると、Injectiveを含むアプリケーションを非常に迅速に構築できます。 +しかし、間違った方向に非常に速く構築することは理想的ではありません。 +ここでは、効果的なAIソフトウェアエンジニアリングに役立つskill、agent、workflow、MCP serverを紹介します。 + +## どのような種類の生成AIツールが利用可能か？ + +- **LLM** - + 大規模言語モデル（LLM）は、ほぼすべての生成AIソフトウェアエンジニアリングを支える基盤技術です。 + ほぼすべてのAI開発ツールはLLMのラッパーです。 + 代表的なものには、Claude Opus（Anthropic）、Gemini（Google）、Kimi（Moonshot AI）があります。 +- **LLMプロバイダー** - + 低・中位のLLMは消費者向けハードウェアで実行可能です。 + しかし、トップクラスのLLMはリモートでアクセスする必要があります。 + 主に3つの選択肢があります： + - **ローカルプロバイダー** - 例：LM StudioやOllamaの使用。 + - **モデル開発元のリモートプロバイダー** - 例：AnthropicのサブスクリプションでClaude Opusにアクセス。 + - **モデルアグリゲーターのリモートプロバイダー** - 例：OpenRouterのサブスクリプションでClaude Opus、Gemini、Kimiにアクセス。 +- **ツール** - + 関数、スクリプト、コマンドラインインターフェース（CLI）など、LLMが理解または呼び出せるようにパッケージ化されたものです。 + 例えば、LLMにリアルタイム情報（LLMのトレーニング時に利用できなかった情報）にアクセスさせたい場合、 + Web検索やその他のデータAPIを呼び出すツールへのアクセスを与える必要があります。 +- **MCP** - + Model-Context-Protocol（MCP）は、LLMによるツールの検出と呼び出しのために設計されたプロトコルです。 + 異なるLLMやLLMプロバイダーがツールを呼び出す方法を標準化するために設計されています。 + 以前は、各LLMやLLMプロバイダーがそれぞれ独自の標準/プロトコルを持っていました。 +- **Skill** - + オプションでサポートリソース、ツール、MCP serverなどを参照するmarkdownファイルです。 + AIエンジニアリングハーネスで動作するように特別に設計されています（他のコンテキストでも使用可能）。 + 再帰的に使用でき、例えばskillが他のskillを参照することができます。 + 「workflow」、「subagent」、「agent」と呼ばれることもあります。 + このコンテキストでは、workflowは通常、定義された順序を持つskillのセットです。 + agent/subagentは、順序が指定されていないworkflowとskillのセットで、 + LLMがどれを使用するかとその順序について裁量権を持ちます。 + 「agent」という用語は多用されており、複数の定義があるため、 + 上記はこのコンテキストに固有のものです。 +- **AIエンジニアリングIDE** - + 専用のIDE、またはIDE内のプラグインで、LLMにプロンプトを送信し、 + ツール呼び出しやMCPの実行を含め、 + その出力をIDE内で開いているコードベースの作業に使用できます。 + 代表的なものには：Roo、Cline、Cursorがあります。 +- **AIエンジニアリングハーネス** - + コーディングタスクのためにLLMを呼び出すことを中心に設計されたコマンドラインインターフェース（CLI）またはターミナルユーザーインターフェース（TUI）です。 + ファイルシステム上で直接動作し、エンジニアリングタスク用の最適化やユーティリティが組み込まれていることが多いです。 + skill、workflow、agentを使用する際に最適に動作するため、 + AIエンジニアリングIDEよりも強力な傾向があります。 + 代表的なものには：Claude Code（Anthropic）、Codex（OpenAI）、OpenCode（無所属）があります。 +- **AIエンジニアリングオーケストレーター** - + ハーネスのラッパーとして機能するツールです。 + 主な目的は、ハーネス呼び出しの長時間実行ループや並列化を可能にし、 + 常に人間が監視する必要なく、LLMがより長く複雑なタスクに自律的に取り組めるようにすることです。 + 代表的なものには：Ralph、GSDがあります。 + +## Injectiveで開発する際、どの種類の生成AIツールが使えるか？ + +LLM、LLMプロバイダー、ツール、MCP、Skill、Workflow、Agent、AIエンジニアリングIDE、AIエンジニアリングハーネス、AIエンジニアリングオーケストレーター。 +つまり、すべてが使えます！ +それこそが、この**AI開発者**セクションの目的です！ + +## Skill + +### Injective CLI Skill + +[Injective CLI skill](/developers-ai/injective-cli-skill)のインストールと使用方法。 + +`injectived`バイナリを使用して、一貫したウォレット処理、エンドポイント選択、gas設定で +Injectiveチェーンに対するクエリとトランザクションを実行します。 + +### Injective EVM Developer Skill + +[Injective EVM Developer skill](/developers-ai/injective-evm-developer-skill)のインストールと使用方法。 + +InjectiveのEVM上で構築する場合、 +EVM互換ネットワークに適用可能な一般的なEVM開発スキルが必要です。 +また、InjectiveのEVMに固有の知識も必要です。 +このskillは、既存のEVM開発スキルを拡張して、それらを提供します。 + +### Injective MCP Servers Skill + +[Injective MCP Servers skill](/developers-ai/injective-mcp-servers-skill)のインストールと使用方法。 + +### Injective Trading Skills + +[Injective Trading skills](/developers-ai/injective-trading-skills)のインストールと使用方法。 + +これは複数のskillのセットで、目的に応じて組み合わせて使用できます。 +Account、auto-sign、bridge、chain analysis、market data、staking、tokensの各コンテキストで使用されます。 + +## MCP Server + +### Injective Documentation MCP + +このドキュメントサイトから最新情報を取得するための +[Injective Documentation MCP server](/developers-ai/documentation-mcp)の使用方法。 + +LLMにInjectiveについて質問すると、 +高速に発展する技術と同様に、古い情報を返す可能性が高いです。 +これは、その情報がトレーニングデータから取得されており、 +定義上「時間が凍結された」ものだからです。 +このMCPをAI開発ワークフローに追加することで、 +Injectiveでの開発に関する最新情報を取得できるだけでなく、 +このドキュメントサイトのURLの形で引用情報も得られます。 + +### Injective MCP + +Injectiveでの完全なトレーディング機能をAIツールに提供する +[Injective MCP server](/developers-ai/mcp)の使用方法。 +perpetual futures、spotトランスファー、クロスチェーンブリッジ、rawなEVMトランザクションを含みます。 diff --git a/.gitbook/ja/developers-ai/injective-cli-skill.mdx b/.gitbook/ja/developers-ai/injective-cli-skill.mdx new file mode 100644 index 00000000..2f9eed73 --- /dev/null +++ b/.gitbook/ja/developers-ai/injective-cli-skill.mdx @@ -0,0 +1,31 @@ +--- +title: Injective CLI Agent Skill +description: AIエンジニアリングハーネスでInjective CLI Agent Skillを使用する +--- + +`injectived`バイナリを使用して、一貫したウォレット処理、エンドポイント選択、gas設定で +Injectiveチェーンに対するクエリとトランザクションを実行します。 + +## インストール + +skillのインストール： + +```bash +uvx upd-skill InjectiveLabs/injective-cli +``` + +skillのグローバルインストール： + +```bash +uvx upd-skill InjectiveLabs/injective-cli --global +``` + +NPX経由でインストール： + +```bash +npx skills add https://github.com/InjectiveLabs/agent-skills --skill injective-cli +``` + +## 使用方法 + +skillをインストールした後、ハーネスにプロンプトを入力してこのskillを使用してください。 diff --git a/.gitbook/ja/developers-ai/injective-evm-developer-skill.mdx b/.gitbook/ja/developers-ai/injective-evm-developer-skill.mdx new file mode 100644 index 00000000..42efb794 --- /dev/null +++ b/.gitbook/ja/developers-ai/injective-evm-developer-skill.mdx @@ -0,0 +1,26 @@ +--- +title: Injective EVM Developer Agent Skill +description: AIエンジニアリングハーネスでInjective EVM Developer Agent Skillを使用する +--- + +Injective上でEVMスマートコントラクトとdAppを開発します。 + +## インストール + +NPM経由で現在のディレクトリにインストール（現在のプロジェクトのみで使用）： + +```bash +npx skills add InjectiveLabs/agent-skills --skill injective-evm-developer +``` + +NPM経由でグローバルにインストール（すべてのプロジェクトで使用）： + +```bash +npx skills add InjectiveLabs/agent-skills --global --skill injective-evm-developer +``` + +## 使用方法 + +サンプルプロンプトについては、skillディレクトリ内の`references/sample-prompts.md`を参照してください。 + +skillをインストールした後、ハーネスにプロンプトを入力してこのskillを使用してください。 diff --git a/.gitbook/ja/developers-ai/injective-mcp-servers-skill.mdx b/.gitbook/ja/developers-ai/injective-mcp-servers-skill.mdx new file mode 100644 index 00000000..69937a23 --- /dev/null +++ b/.gitbook/ja/developers-ai/injective-mcp-servers-skill.mdx @@ -0,0 +1,26 @@ +--- +title: Injective MCP Servers Skill +description: AIエンジニアリングハーネスでInjective MCP Servers Skillを使用する +--- + +Injective MCP serverのセットアップと実行を行います。 +どのMCP serverを使用するかの選択を支援します。 + + + Injectiveには2つのMCP serverがあります： + - [Injective Documentation MCP Server](/developers-ai/documentation-mcp/) + - [Injective MCP Server](/developers-ai/mcp/) + + +## インストール + +NPX経由でインストール： + +```bash +npx skills add https://github.com/InjectiveLabs/agent-skills \ + --skill injective-mcp-servers +``` + +## 使用方法 + +skillをインストールした後、ハーネスにプロンプトを入力してこのskillを使用してください。 diff --git a/.gitbook/ja/developers-ai/injective-trading-skills.mdx b/.gitbook/ja/developers-ai/injective-trading-skills.mdx new file mode 100644 index 00000000..8b43e74a --- /dev/null +++ b/.gitbook/ja/developers-ai/injective-trading-skills.mdx @@ -0,0 +1,70 @@ +--- +title: Injective Trading Skills +description: AIエンジニアリングハーネスでInjective Trading Agent Skillのセットを使用する +--- + +**Injective Trading Account** - 任意のInjectiveウォレットアドレスを分析します。 +すべてのトークンタイプ（INJ、USDT、IBCアセット、Peggy ERC-20）のbank残高をクエリし、 +トレーディングsubaccount残高を確認し、未実現P&Lを含むオープンなperpetualポジションを表示します。 +ポートフォリオモニタリング、ポジション管理、プレトレードチェックに役立ちます。 +Injective MCP serverの接続が必要です。 + +**Injective Trading Autosign** - セッションベースの自動トレーディングのためにInjectiveでAuthZデリゲーションを設定します。 +一時的なキーにスコープ付きの期限付き権限を付与し、AIが注文ごとにウォレットポップアップやパスワードプロンプトなしで +perpetualトレードの発注とクローズを行えるようにします。 +有効にするにはauthz_grant、無効にするにはauthz_revokeを使用します。 +Injective MCP serverの接続が必要です。 + +**Injective Trading Bridge** - deBridge DLN（高速、クロスチェーン）またはPeggy（Ethereumカノニカルブリッジ）を使用して +Injectiveとの間でトークンをブリッジします。 +Arbitrum、Ethereum、Base、Polygon、BSC、Avalanche、OptimismからInjectiveへのインバウンドブリッジ、 +およびInjectiveからdeBridge対応チェーンへのアウトバウンドブリッジをサポートします。 +実行前に見積もりを取得してください。 +Injective MCP serverの接続が必要です。 + +**Injective Trading Chain Analysis** - Injectiveのチェーンレベルのコードとプロトコル仕様を分析します。 +injective-coreからGoソースを読み取り、exchangeモジュールの機能 +（ポジションオフセッティング、清算、マージンティア、ファンディング）を説明し、仕様のギャップを特定します。 +チェーンメカニクスの議論、Injective Goコードのレビュー、プロトコル動作の説明に使用します。 + +**Injective Trading Market Data** - Injective perpetual futuresマーケットのリアルタイムマーケットデータにアクセスします。 +Oracle価格のクエリ、メタデータ付きのすべてのアクティブマーケットのリスト表示（tick size、最小notional、最大レバレッジ）、 +現在のスプレッドとファンディング情報の取得を行います。 +Injective MCP serverの接続が必要です。 + +**Injective Trading Staking** - Injectiveのステーキングデリゲーション、報酬、バリデーター情報のクエリと管理を行います。 +Injective LCD/REST APIを通じて、ステーカーアドレス、デリゲーション額、アンボンディングステータス、請求済み報酬を検索します。 + +**Injective Trading Tokens** - 任意のInjectiveトークンまたはdenomのメタデータを検索します。 +ネイティブトークン（INJ）、Peggy ERC-20ブリッジトークン（USDT、USDC、WETH）、IBCアセット（ATOM、OSMO）、 +TokenFactoryトークン、EVM ERC-20を人間が読めるシンボル、decimals、タイプに解決します。 +アドレス間でのトークン送信やトレーディングsubaccountへの入出金もサポートします。 +Injective MCP serverの接続が必要です。 + +## インストール + +NPX経由でインストール： + +```bash +npx skills add https://github.com/InjectiveLabs/agent-skills \ + --skill injective-trading-account +npx skills add https://github.com/InjectiveLabs/agent-skills \ + --skill injective-trading-autosign +npx skills add https://github.com/InjectiveLabs/agent-skills \ + --skill injective-trading-bridge +npx skills add https://github.com/InjectiveLabs/agent-skills \ + --skill injective-trading-chain-analysis +npx skills add https://github.com/InjectiveLabs/agent-skills \ + --skill injective-trading-market-data +npx skills add https://github.com/InjectiveLabs/agent-skills \ + --skill injective-trading-staking +npx skills add https://github.com/InjectiveLabs/agent-skills \ + --skill injective-trading-tokens +``` + +上記のコマンドは、すべてのトレーディング関連skillをインストールします。 +目的に応じて、一部のみをインストールすることもできます。 + +## 使用方法 + +skillをインストールした後、ハーネスにプロンプトを入力して使用してください。 diff --git a/.gitbook/ja/developers-ai/mcp.mdx b/.gitbook/ja/developers-ai/mcp.mdx new file mode 100644 index 00000000..668c4742 --- /dev/null +++ b/.gitbook/ja/developers-ai/mcp.mdx @@ -0,0 +1,100 @@ +--- +title: Injective MCP Server +description: Model Context Protocol（MCP）を使用してAIアシスタントをInjectiveに接続する +--- + +Injective MCP serverは、Injectiveでの完全なトレーディング機能を提供します。 +perpetual futures、spotトランスファー、クロスチェーンブリッジ、rawなEVMトランザクションを含みます。 + +これはAIツールにInjectiveでのトレーディング能力を与えるため、非常に強力です。 +このサーバーは[Injective Trading Skills](/developers-ai/injective-trading-skills)で広く使用されるように設計されています。 +AIツールにこのMCP serverの使用方法を教えるには、 +[Injective MCP Servers Skill](/developers-ai/injective-mcp-servers-skill)を使用してください。 + +## MCPとは？ + +[MCP](https://modelcontextprotocol.io/introduction)は、AIアシスタントが外部データソースやツールに接続できるようにする**オープンスタンダード**です。 +トレーニングデータのみに頼るのではなく、AIアシスタントはMCPを使用してドキュメントからリアルタイムで +信頼性の高い情報に直接アクセスできます。 + +## なぜInjective MCP serverを使用するのか？ + +AIツールをInjective MCP serverに接続すると、以下が可能になります： + +- より情報に基づいたトレードのための一般的なクエリやリサーチタスクの実行 +- 自律的なトレーディング（独自のトレーディングロジック/指示を持ち込み可能） + +これはInjectiveでのトレーディングに特に有用で、 +AIが話し言葉でトレーディング意図を表現する手助けをします。 + +## MCP serverの詳細 + +| プロパティ | 値 | +|----------|-------| +| Endpoint | localhost | +| Transport | stdio | +| 利用可能なツール | 複数、[MCP serverの使用](#mcp-serverの使用)を参照 | + +## MCP serverへの接続 + + + + MCP対応クライアントの場合、サーバーをローカルでセットアップして実行します： + + ```shell + git clone https://github.com/InjectiveLabs/mcp-server injective-mcp-server + cd injective-mcp-server + npm install && npm run build + ``` + + + + Claude Desktopの設定ファイルに以下を追加します： + + + + `~/Library/Application Support/Claude/claude_desktop_config.json`を編集： + + ```json + { + "mcpServers": { + "injective": { + "command": "node", + "args": ["/path/to/injective-mcp-server/dist/mcp/server.js"], + "env": { + "INJECTIVE_NETWORK": "mainnet" + } + } + } + } + ``` + + + `%APPDATA%\Claude\claude_desktop_config.json`を編集： + + ```json + { + "mcpServers": { + "injective": { + "command": "node", + "args": ["/path/to/injective-mcp-server/dist/mcp/server.js"], + "env": { + "INJECTIVE_NETWORK": "mainnet" + } + } + } + } + ``` + + + + 設定を保存した後、Claude Desktopを再起動してください。Injective Docsツールがclaudeの利用可能なツールに表示されます。 + + + +## MCP serverの使用 + +接続後、AIツールにInjectiveでのクエリとトランザクションの実行を依頼できます。 + +利用可能なすべてのツールのリストは +[`github.com/InjectiveLabs/mcp-server`](https://github.com/InjectiveLabs/mcp-server?tab=readme-ov-file#tools)で確認できます。