Exemplo de Servidor MCP

MCP サーバーの例

Código Fonte TV チャンネルの教育目的で作成されたこのプロジェクトでは、外部 API との連携とデータ検証を備えた MCP サーバーの構築方法を紹介します。

このリポジトリには、米国の National Weather Service（NWS）API を使用して気象情報を取得する 2 つのツールを提供する、Node.js/TypeScript での MCP（Model Context Protocol）サーバー実装例が含まれています。

機能

• get-alerts：州のコード（2 文字、例：CA、NY）を指定して、現在有効な気象警報を取得します。
• get-forecast：地理座標（緯度、経度）を指定して、天気予報を取得します。
• Zod を使用して入力を検証します。
• fetch を使用して NWS API と連携します（インフラストラクチャ層）。
• MCP プロトコル（@modelcontextprotocol/sdk）を使用して stdio 経由で通信します。

アーキテクチャ

このプロジェクトでは、ドメイン駆動設計（DDD）のパターンを参考にしたレイヤードアーキテクチャを採用しています。

• ドメイン（src/domain）： データ構造（例：AlertFeature、ForecastPeriod、AlertsResponse）を表すインターフェースと型を定義します。

• インフラストラクチャ（src/infrastructure）： 外部サービスを実装します。たとえば、NWS API への HTTP リクエストを担当する NWSApiService があります。

• アプリケーション（src/application）： インフラストラクチャから渡されるデータを処理、整形する WeatherService にビジネスロジックを実装します。

• インターフェース（src/interface）： WeatherToolsController などのコントローラーが含まれます。これらは MCP サーバーにツールを登録し、検証スキーマを定義して結果を返します。

• エントリーポイント（src/main.ts）： McpServer を初期化し、トランスポート（StdioServerTransport）を設定して、サービスとコントローラーをインスタンス化し、stdio での待ち受けを開始します。

フォルダー構成は次のとおりです。

src/
├── domain/
│   └── models/           # Interfaces de domínio
├── infrastructure/
│   └── services/         # Implementações da API externa (NWS)
├── application/
│   └── services/         # Lógica de negócio e formatação de dados
├── interface/
│   └── controllers/      # Registro das ferramentas MCP e validação
└── main.ts               # Ponto de entrada do servidor
build/                     # Código JavaScript compilado

インストール

git clone <REPOSITÓRIO_URL>
cd mcp-server-sample
npm install
npm run build

使用方法

ビルド後、サーバーを直接実行できます。

node build/main.js

または、バイナリ（weather）として登録されている場合は、次のように実行できます。

npm link
weather

サーバーは標準出力（stdio）で起動し、MCP リクエストを待ち受けます。

コントリビューション

プルリクエストを歓迎します。お気軽に issue を作成し、改善についてご相談ください。

Código Fonte TV

実装の詳細については、Código Fonte TV チャンネルの動画をご覧ください。