Enjin API Tool MCP Server について
MCP 対応 IDE から Enjin Platform API を利用するためのサーバーです。NFT コレクションの作成と取得に対応します。
主な機能
- 01NFT コレクションの作成
- 02ID によるコレクション取得
- 03環境変数での API エンドポイントとキーの設定
- 04認証エラーと API エラーへの対応
活用シーン
- 01Enjin Platform でコレクションを作成
- 02ID を指定して既存のコレクションを取得
MCP 対応
Enjin Platform API の操作を MCP クライアント向けのツールとして提供し、NFT コレクションの作成と取得に対応します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Enjin API Tool MCP サーバー
この MCP サーバーを使用すると、Enjin Platform API とやり取りできます。
前提条件
- Node.js(v16 以降)
- MCP 対応 IDE
- Enjin Platform API キー
セットアップ手順
1. Enjin Platform API キーを取得する
- Enjin Platform にアカウントを作成します。
- API キーを生成します。
2. プロジェクトの初期セットアップ
依存関係をインストールします。
npm install
3. 環境変数を設定する
ローカル開発用に .env ファイルを作成する(このファイルはコミットしないでください)か、IDE の MCP サーバー設定で環境変数を定義します。
例:
ENJIN_API_ENDPOINT=https://platform.canary.enjin.io/graphql
ENJIN_API_KEY=your-enjin-api-key
4. MCP 対応 IDE を設定する
使用する IDE 固有の手順に従って、MCP サーバーを設定します。通常は、以下の操作を行います。
- 新しいサーバー設定を追加します。
- サーバーの実行コマンド(例:
node build/index.js)を指定します。 - 環境変数(例:
ENJIN_API_KEY)を設定します。
詳しい手順については、IDE のドキュメントを参照してください。
利用可能なツール
現在、サーバーは以下のツールを提供しています。
create_collection
Enjin Platform に新しい NFT コレクションを作成します。以下のパラメーターが必要です。
name:(string)コレクションの名前。description:(string)コレクションの説明。media:(string)コレクションメディアの URL。
get_collection
Enjin Platform からコレクションを取得します。以下のパラメーターが必要です。
collection_id:(string)コレクションの ID。
型定義
// Example type definitions - adjust based on your API responses
interface EnjinApiError {
status?: number;
message: string;
code?: string;
}
interface Collection {
id: string;
name: string;
description: string;
media: string;
// ... other collection properties
}
エラー処理
サーバーはさまざまなエラー状況に対応します。
環境エラー
ENJIN_API_KEYが未設定- API キーが無効
API エラー
- レート制限
- リクエストパラメーターが無効
- サーバー内部エラー
トラブルシューティング
よくある問題
IDE にツールが表示されない
- IDE のログを確認します
ENJIN_API_KEYが正しく設定されていることを確認します- サーバーが実行中であることを確認します
認証エラー
- API キーが有効であることを確認します
- キーに必要な権限があるか確認します
ログの表示
サーバーログを表示する方法については、MCP サーバーのログの表示方法に関する IDE のドキュメントを参照してください。
環境変数
環境変数エラーが発生する場合は、以下を確認してください。
ENJIN_API_ENDPOINT:有効な Enjin Platform API エンドポイントである必要がありますENJIN_API_KEY:有効な Enjin Platform API キーである必要があります
セキュリティに関する考慮事項
- API キーを安全に保管してください
- 認証情報をバージョン管理にコミットしないでください
- 機密データには環境変数を使用してください
- API キーを定期的にローテーションしてください
- Enjin Platform で API の使用状況を監視してください
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。