Yokai MCP Server Template

Yokai MCP サーバー テンプレート

Yokai Go フレームワークをベースにしたMCP サーバーテンプレートです。

• ドキュメント
• 概要
  • レイアウト
  • Makefile
• はじめに
  • インストール
    • GitHub を使用
    • gonew を使用
  • 使い方

ドキュメント

Yokai フレームワークの詳細については、ドキュメントをご確認ください。

概要

このテンプレートには、以下が用意されています。

• MCP サーバーモジュールをインストール済みの、すぐに拡張できるYokaiアプリケーション
• ライブリロード用のAirをベースにした、すぐに使える開発環境
• 本番環境用の、すぐに使えるDockerfile
• 開発を始めるためのMCP ツールとテストの例

レイアウト

このテンプレートは、推奨されるプロジェクトレイアウトに従っています。

• cmd/：エントリーポイント
• configs/：設定ファイル
• internal/：
  • tool/：MCP ツールとテストの例
  • bootstrap.go：ブートストラップ
  • register.go：依存関係の登録

Makefile

このテンプレートにはMakefileが用意されています。

make up      # start the docker compose stack
make down    # stop the docker compose stack
make logs    # stream the docker compose stack logs
make fresh   # refresh the docker compose stack
make test    # run tests
make lint    # run linter

はじめに

インストール

GitHub を使用

GitHub テンプレートを使用して、リポジトリを作成できます。

プロジェクトのリソース名は自動的に変更され、プッシュされます。この操作には数分かかる場合があります。

準備ができたら、リポジトリをクローンして移動し、次のコマンドを実行します。

make fresh

gonew を使用

gonewをインストールし、次のコマンドを実行します。

gonew github.com/ankorstore/yokai-mcp-template github.com/foo/bar
cd bar
make fresh

使い方

準備ができると、アプリケーションは次の場所で利用できます。

• アプリケーションの MCP サーバー：http://localhost:8080/sse
• アプリケーションのコアダッシュボード：http://localhost:8081