Agent8 用 MCP サーバー

Agent8 SDK開発をサポートするために、モデルコンテキストプロトコル（MCP）を実装したサーバーです。TypeScriptとpnpmを使用して開発され、stdio、SSE、およびstreamable-httpトランスポートをサポートしています。

特徴

この Agent8 MCP サーバーは、次の MCP 仕様機能を実装します。

プロンプト

Agent8 SDK のシステムプロンプト: system-prompt-for-agent8-sdkプロンプトテンプレートを通じて、Agent8 SDK 開発用に最適化されたガイドラインを提供します。

ツール

コード例の検索: search_code_examplesツールを使用して、ベクターデータベースから関連する Agent8 ゲーム開発コード例を取得します。
ゲームリソース検索: search_game_resourcesツールによるセマンティック類似性マッチングを使用して、ゲーム開発アセット (スプライト、アニメーション、サウンドなど) を検索します。
アセット生成: ゲームアセット作成のための包括的なツールセット:
- 画像: image_asset_generateツールを使用して 2D ゲームアセットを生成します
- シネマティック: cinematic_asset_generateツールを使用してシネマティックシーケンスを作成する
- オーディオ: music_generateおよびsfx_generateツールを使用して音楽トラックとサウンドエフェクトを生成します
- スカイボックス: skybox_generateツールを使用して 360° 環境背景を作成します
- サポートツール: ステータスチェック、結果取得、非同期生成の待機ユーティリティ

インストール

# Install dependencies
pnpm install

# Build
pnpm build

Dockerの使用

このアプリケーションは、Docker を使用していくつかの方法で実行できます。

オプション 1: GitHub Container Registry からプルする (推奨)

# Pull the latest image
docker pull ghcr.io/planetarium/mcp-agent8:latest

# Run the container
docker run -p 3333:3333 --env-file .env ghcr.io/planetarium/mcp-agent8:latest

オプション2: ローカルで構築する

# Build the Docker image
docker build -t agent8-mcp-server .

# Run the container with environment variables
docker run -p 3333:3333 --env-file .env agent8-mcp-server

Docker環境の設定

Docker で実行するときに環境変数を構成する方法は 3 つあります。

--env-file使用 (推奨):
# Create and configure your .env file first cp .env.example .env nano .env # Run with .env file docker run -p 3000:3000 --env-file .env agent8-mcp-server
個別の-eフラグの使用:
docker run -p 3000:3000 \ -e SUPABASE_URL=your_supabase_url \ -e SUPABASE_SERVICE_ROLE_KEY=your_service_role_key \ -e OPENAI_API_KEY=your_openai_api_key \ -e MCP_TRANSPORT=sse \ -e PORT=3000 \ -e LOG_LEVEL=info \ agent8-mcp-server
Docker Compose の使用 (開発/本番環境セットアップ用):プロジェクトには、次の内容が事前設定されたdocker-compose.ymlファイルが含まれています。
- .env 構成からの自動ポートマッピング
- 環境変数の読み込み
- データの永続性のためのボリュームマウント
- コンテナの自動再起動ポリシー
- ヘルスチェックの設定
サーバーを実行するには:
docker compose up
デタッチドモードで実行するには:
docker compose up -d

必要な環境変数:

SUPABASE_URL : データベース接続用の Supabase URL
SUPABASE_SERVICE_ROLE_KEY : 認証用のSupabaseサービスロールキー
OPENAI_API_KEY : AI機能用のOpenAI APIキー

Dockerfile は、マルチステージビルドプロセスを使用して最小限の製品イメージを作成します。

より小さいサイズのためにNode.js 20 Alpineをベースイメージとして使用します
ビルドとランタイムの依存関係を分離する
最終画像には必要なファイルのみを含める
デフォルトでポート3000を公開します

使用法

コマンドラインオプション

# View help
pnpm start --help

# View version information
pnpm start --version

サポートされているオプション:

--debug : デバッグモードを有効にする
--transport <type> : トランスポートタイプ (stdio、sse、または streamable-http)、デフォルト: stdio
--port <number> : SSEまたはHTTPトランスポートに使用するポート、デフォルト: 3000
--log-destination <dest> : ログの保存先 (stdout、stderr、ファイル、なし)
--log-file <path> : ログファイルへのパス（ログ出力先がファイルの場合）
--log-level <level> : ログレベル (debug、info、warn、error)、デフォルト: info
--env-file <path> : .env ファイルへのパス

環境変数の使用

サーバーは環境変数による構成をサポートしており、環境変数は直接または.envファイル経由で設定できます。

プロジェクトルートに.envファイルを作成します (参考として.env.exampleを参照してください)。

# Copy the example file
cp .env.example .env

# Edit the .env file with your settings
nano .env

サーバーを実行します ( .envファイルが自動的にロードされます)。

pnpm start

または、 .envファイルへのカスタムパスを指定します。

pnpm start --env-file=/path/to/custom/.env

構成の優先順位

サーバーは、構成値を決定するときに次の優先順位を使用します。

コマンドライン引数（最高優先度）
環境変数（ .envファイルまたはシステム環境から）
デフォルト値（最低優先度）

これにより、必要に応じてコマンドライン引数を使用して特定の設定を上書きしながら、 .envファイルでベースライン構成を設定できます。

サポートされている環境変数

変数	説明	デフォルト
MCP_トランスポート	トランスポートタイプ（stdio、sse、またはstreamable-http）	標準入出力
ポート	SSEトランスポートに使用するポート	3000
ログレベル	ログレベル（デバッグ、情報、警告、エラー）	情報
ログ宛先	ログの保存先（stdout、stderr、ファイル、なし）	stderr (stdio トランスポート用)、stdout (sse トランスポート用)
ログファイル	ログファイルへのパス（LOG_DESTINATIONがファイルの場合）	（なし）
デバッグ	デバッグモードを有効にする (true/false)	間違い
V8_AUTH_API_ENDPOINT	認証APIエンドポイントURL	（なし）
V8_AUTH_REQUIRE	APIエンドポイントに認証を要求する	間違い
SUPABASE_URL	データベース接続用の Supabase URL	（必須）
SUPABASE_SERVICE_ROLE_KEY	認証用の Supabase サービスロールキー	（必須）
OPENAI_API_KEY	AI機能用のOpenAI APIキー	（必須）
FAL_KEY	アセット生成用のfal.ai APIキー	（必須）
BLOCKADE_LABS_API_KEY	スカイボックス生成用のBlockade Labs APIキー	（スカイボックス生成に必要）
V8_クレジット_クライアントID	クレジット消費APIのクライアントID	(なし、アセット生成の場合はオプション)
V8_クレジット_クライアント_シークレット	クレジット消費APIのクライアントシークレット	(なし、アセット生成の場合はオプション)
V8_クレジット_API_エンドポイント	クレジット消費用のAPIエンドポイント	（アセット生成に必要）
すべてのツールを有効にする	すべてのツールをグローバルに有効または無効にする	真実
ベクター検索ツールを有効にする	すべてのベクター検索ツールを有効または無効にする	真実
アセット生成ツールを有効にする	すべてのアセット生成ツール（画像、シネマティック、オーディオ、スカイボックス）を有効または無効にします	真実
画像生成ツールを有効にする	画像生成ツールを有効または無効にする	真実
シネマティック生成ツールを有効にする	シネマティック生成ツールを有効または無効にする	真実
オーディオ生成ツールを有効にする	オーディオ生成ツールを有効または無効にする	真実
ENABLE_SKYBOX_GENERATION_TOOLS	スカイボックス生成ツールを有効または無効にする	真実
ENABLE_CODE_EXAMPLE_SEARCH_TOOL	コード例検索ツールを有効または無効にする	真実
ゲームリソース検索ツールを有効にする	ゲームリソース検索ツールを有効または無効にする	真実
UIテーマツールを有効にする	UIテーマツールを有効または無効にする	真実

ツールのアクティベーションの優先順位: ツールのアクティベーション設定は次の優先順位に従います。

個別のツール設定（例： ENABLE_CODE_EXAMPLE_SEARCH_TOOL ）
アセットタイプの設定（例： ENABLE_IMAGE_GENERATION_TOOLS 、 ENABLE_CINEMATIC_GENERATION_TOOLS ）
ツールグループ設定（例： ENABLE_VECTOR_SEARCH_TOOLS 、 ENABLE_ASSET_GENERATE_TOOLS ）
グローバルツール設定 ( ENABLE_ALL_TOOLS )

個別設定は常にグループ設定をオーバーライドし、グループ設定はグローバル設定をオーバーライドします。個別設定が明示的に指定されている場合、親設定よりも優先されます。

重要：特定のツールのみを有効にするには、上位レベルの設定をすべてfalseに設定し、必要なツールのみを有効にする必要があります。この方法により、より一貫性があり、予測可能な構成を実現できます。

例:

# Enable only vector search tools
ENABLE_ALL_TOOLS=false
ENABLE_VECTOR_SEARCH_TOOLS=true

# Enable only image generation tool, disable all others
ENABLE_ALL_TOOLS=false
ENABLE_ASSET_GENERATE_TOOLS=false
ENABLE_IMAGE_GENERATION_TOOLS=true

# Enable only code example search tool, disable all others
ENABLE_ALL_TOOLS=false
ENABLE_VECTOR_SEARCH_TOOLS=false
ENABLE_CODE_EXAMPLE_SEARCH_TOOL=true

# Enable only cinematic and audio generation tools
ENABLE_ALL_TOOLS=false
ENABLE_ASSET_GENERATE_TOOLS=false
ENABLE_CINEMATIC_GENERATION_TOOLS=true
ENABLE_AUDIO_GENERATION_TOOLS=true

Stdioトランスポートの使用

# Build and run
pnpm build
pnpm start --transport=stdio

SSEトランスポートの使用

# Build and run (default port: 3000)
pnpm build
pnpm start --transport=sse --port=3000

ストリーミング可能なHTTPトランスポートの使用

# Build and run (default port: 3000)
pnpm build
pnpm start --transport=streamable-http --port=3000

デバッグモード

# Run in debug mode
pnpm start --debug

利用可能なプロンプト

systemprompt-agent8-sdk

クライアント統合

Claude Desktopでの使用

Claude Desktop 構成ファイル ( claude_desktop_config.json ) に以下を追加します。

{
  "mcpServers": {
    "Agent8": {
      "command": "npx",
      "args": ["--yes", "agent8-mcp-server"]
    }
  }
}

Claudeデスクトップを再起動します

新しいプロンプトの追加

src/prompts/provider.tsファイルのregisterSamplePromptsメソッドに新しいプロンプトを追加します。

ライセンス

マサチューセッツ工科大学

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

モデルコンテキストプロトコル (MCP) を実装し、stdio および SSE トランスポートを通じてシステムプロンプトとコード例の検索機能を提供することで Agent8 SDK 開発をサポートするサーバー。

Related MCP Servers

n8n MCP Server
illuminaresolutions
A
security
A
license
A
quality
An MCP server enabling secure interaction with n8n workflows, executions, and settings via the Model Context Protocol, designed for integration with Large Language Models (LLMs).
Last updated -
33
65
34
TypeScript
MIT License
MCP Shell Server
mkusaka
A
security
A
license
A
quality
A server that uses the Model Context Protocol (MCP) to allow AI agents to safely execute shell commands on a host system.
Last updated -
1
76
2
TypeScript
MIT License
Hello World MCP Server
jageenshukla
-
security
A
license
-
quality
A demonstration server that implements the Model Context Protocol (MCP) SDK, providing tools and endpoints for server-sent events and message handling.
Last updated -
27
TypeScript
MIT License
Xava Labs MCP Template
xava-labs
-
security
A
license
-
quality
A template repository for building Model Context Protocol (MCP) servers that enables developers to create interactive AI agents with real-time bidirectional communication capabilities through WebSocket and SSE endpoints.
Last updated -
TypeScript
MIT License

View all related MCP servers

MCP Server for Agent8