hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Supports configuration via .env files for managing environment variables
Provides containerized deployment options through Docker, including GitHub Container Registry integration
Offers container image distribution through GitHub Container Registry

Agent8 用 MCP サーバー

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

特徴

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

プロンプト

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

ツール

コード例の検索: search_code_examplesツールを使用して、ベクターデータベースから関連する Agent8 ゲーム開発コード例を取得します。
ゲームリソース検索: search_game_resourcesツールによるセマンティック類似性マッチングを使用して、ゲーム開発アセット (スプライト、アニメーション、サウンドなど) を検索します。

インストール

# 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）、デフォルト: stdio
--port <number> : SSEトランスポートに使用するポート、デフォルト: 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）	標準入出力
ポート	SSEトランスポートに使用するポート	3000
ログレベル	ログレベル（デバッグ、情報、警告、エラー）	情報
ログ宛先	ログの保存先（stdout、stderr、ファイル、なし）	stderr (stdio トランスポート用)、stdout (sse トランスポート用)
ログファイル	ログファイルへのパス（LOG_DESTINATIONがファイルの場合）	（なし）
デバッグ	デバッグモードを有効にする (true/false)	間違い
SUPABASE_URL	データベース接続用の Supabase URL	（必須）
SUPABASE_SERVICE_ROLE_KEY	認証用の Supabase サービスロールキー	（必須）
OPENAI_API_KEY	AI機能用のOpenAI APIキー	（必須）
すべてのツールを有効にする	すべてのツールをグローバルに有効または無効にする	真実
ベクター検索ツールを有効にする	すべてのベクター検索ツールを有効または無効にする	真実
シネマティックツールを有効にする	すべてのシネマティックツールを有効または無効にする	真実
ENABLE_CODE_EXAMPLE_SEARCH_TOOL	コード例検索ツールを有効または無効にする	真実
ゲームリソース検索ツールを有効にする	ゲームリソース検索ツールを有効または無効にする	真実

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

個別のツール設定（例： ENABLE_CODE_EXAMPLE_SEARCH_TOOL ）
ツールグループ設定（例： ENABLE_VECTOR_SEARCH_TOOLS ）
グローバルツール設定 ( ENABLE_ALL_TOOLS )

例えば、 ENABLE_ALL_TOOLS=falseと設定し、 ENABLE_VECTOR_SEARCH_TOOLS=trueと設定した場合、ベクター検索ツールのみが有効になり、他のツールは無効のままになります。同様に、個々のツール設定は、対応するグループ設定をオーバーライドします。

例:

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

# Disable a specific tool while keeping others enabled
ENABLE_ALL_TOOLS=true
ENABLE_CODE_EXAMPLE_SEARCH_TOOL=false

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

デバッグモード

# 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メソッドに新しいプロンプトを追加します。

ライセンス

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

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

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

MCP Server for Agent8