Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【ITニュース解説】Your Go Service Gets a Third Front Door: An MCP Adapter That Never Touches the Domain

2026年10月20日に「Dev.to」が公開したITニュース「Your Go Service Gets a Third Front Door: An MCP Adapter That Never Touches the Domain」について初心者にもわかりやすく解説しています。

作成日: 更新日:

ITニュース概要

AIアシスタントが既存Goサービスの払い戻し機能を呼び出す新しい方法を解説。ヘキサゴナルアーキテクチャにより、サービスの中核(ビジネスロジック)はそのままに、外部との接続部分(アダプター)だけを追加・変更することで、簡単に機能拡張できる設計手法を紹介する。

ITニュース解説

システムエンジニアを目指す方にとって、ソフトウェア開発における設計の考え方は非常に重要である。特に、システムが複雑になるにつれて、後から機能を追加したり変更したりする際に、どこまで影響が出るかを予測し、変更が容易な構造にしておくことが求められる。この記事は、Go言語で書かれた既存のサービスに、新しい種類のアクセス方法を追加する具体的な例を通じて、そのための設計思想である「ヘキサゴナルアーキテクチャ(Ports and Adapters)」という考え方を紹介している。

ヘキサゴナルアーキテクチャは、システムの中心にビジネスロジックを置き、その周りを外部との接続部分(アダプター)が囲む構造を推奨する。この設計の核となるのは、「中心にあるビジネスロジックは、外部の技術的な詳細に依存してはいけない」という原則である。ビジネスロジックは、データの保存方法や外部からの通信手段(例えばHTTPやAIアシスタントからの命令)といった具体的な技術には関心を持たず、純粋に「何を行うべきか」という業務ルールだけを考える。この中心と外部をつなぐ役割を果たすのが「ポート」と呼ばれるインターフェースである。外部(アダプター)はポートを通じて中心と通信し、中心はポートを通じて外部サービスを利用する。

記事の例では、商品の返金処理を行うサービスを題材にしている。このサービスは、主に三つの部分に分かれている。まず「ドメイン層」と呼ばれる部分が、システムの中核となるビジネスロジックを担う。ここでは、「返金はまだ行われていないか」「返金額は正しいか」といった返金に関するルールが定義され、関連するエラーの種類もここで管理される。このドメイン層は、他のどんな技術的な詳細にも依存せず、純粋な業務ルールだけを扱っている。

次に「アプリケーション層」は、このドメイン層を使って具体的なユースケース、つまり「返金処理を行う」という目的を達成するためのロジックを記述する。この層では、外部からの操作を受け付けるための「駆動するポート」(Refunderインターフェース)と、データ保存などの外部サービスを利用するための「駆動されるポート」(Ordersインターフェース)が定義される。RefundServiceというコンポーネントが、これらのポートを実装することで、実際に返金処理の流れを管理し、ドメイン層のルールに従って返金可否を判断し、データを保存する。

そして「アダプター層」は、アプリケーション層のポートに接続し、外部からの多様な入力をアプリケーション層が理解できる形に変換したり、アプリケーション層からの出力を外部が理解できる形に変換したりする役割を持つ。この記事では、これまでユーザーがウェブブラウザからアクセスするHTTP APIと、開発者などがターミナルから操作するコマンドラインインターフェース(CLI)の二つのアダプターが存在していた。これらはいずれも、アプリケーション層のRefunderポートを呼び出すことで、返金処理を実行している。

今回、新しく「AIアシスタントから返金処理を呼び出したい」という要件が加わった。AIアシスタントは「Model Context Protocol (MCP)」という独自の通信方式でサービスとやり取りするため、これに対応する「第三のアダプター」を追加する必要がある。この新しいMCPアダプターは、既存のHTTPやCLIアダプターと同様に、アプリケーション層のRefunderポートを呼び出す構造になっている。MCPアダプターは、MCP独自の入力形式(refundIn)で情報を受け取り、それをアプリケーション層が期待する形式(app.RefundOrder)に変換して処理を依頼する。処理結果も同様に、アプリケーション層から受け取ったものをMCPの出力形式(refundOut)に変換してAIアシスタントに返す。この設計により、新しい通信方式に対応するためのコードはアダプター層の中に閉じ込められ、ドメイン層やアプリケーション層にはMCPに関する情報が一切入らない状態が保たれる。

特に重要なのはエラーの扱いで、ビジネスロジック上のエラー(例: 「既に返金済み」)はAIアシスタントが状況を理解して次の行動を決められるように「ツール実行エラー」として返し、データベース接続のタイムアウトのようなシステム内部の問題は、詳細を外部に漏らさず「内部エラー」として返すようにアダプターが適切に変換を行う。

このような設計が本当に守られているかをシステム的に確認する工夫も紹介されている。例えば、ビルド時に自動で、ドメイン層やアプリケーション層のコードが、新しく追加されたMCPのSDKやアダプター層のパッケージに誤って依存していないかをチェックする仕組みが導入されている。これにより、システムのコア部分が外部の技術的な詳細に汚染されるのを防ぎ、設計原則が維持されていることを保証できる。

テストの面でも、この設計思想は大きな利点をもたらす。アプリケーション層のユースケース(返金処理)のテストは、実際のデータベースではなく、メモリー上にデータを保持する模擬的なストア(memstore)を使って行われる。これにより、テストは高速に実行でき、外部環境に左右されない安定したテストが可能になる。MCPアダプターのテストも、Go SDKが提供するメモリー内の通信機能を使って行われ、実際に外部と通信することなく、アダプターが正しく動作し、特にエラーが期待通りに処理されることを確認できる。

このようにヘキサゴナルアーキテクチャを採用することで、新しい通信プロトコル(MCP)の追加のような大きな変更があっても、影響範囲は新しいアダプターの追加のみに留まり、システムの中心にある重要なビジネスロジックは一切変更されない。これは、システムの保守性を高め、将来的な拡張を容易にするための強力なアプローチである。また、エラーメッセージ一つとっても、それがAIアシスタントによってどのように解釈され、利用されるかを考慮して記述することの重要性も示唆している。システムの設計段階からこのような分離の原則を意識することで、変化に強く、持続可能なシステムを構築できるのである。

関連コンテンツ

関連IT用語