d365-agent-mcpserver-ts\n\nTypeScript implementation of the MCP Server for the Dynamics 365 AI Agent. について
d365-agent-mcpserver-tsは、MCPクライアント向けのツールを定義・公開するTypeScript/Node.js実装です。カスタムバックエンドや計算ロジックを扱えますが、関連クライアントの既知の問題により、Dynamics 365への接続には制約があるとREADMEに記載されています。
主な機能
- 01入出力スキーマを指定したツール定義
- 02カスタムツール実装のMCPクライアントへの公開
- 03バックエンド、API、独自ロジック向けのツール
- 04Dockerコンテナ化を想定した設計
活用シーン
- 01独自ロジックをMCPクライアントに公開
- 02バックエンドシステムやAPI向けのツール提供
- 03MCPツールサーバーのDockerコンテナ化
MCP 対応
MCPクライアントはツールとスキーマを検出し、ツールを呼び出して結果またはエラーを受け取れます。サーバーはツールの定義と実行を担います。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Dynamics 365 AI Agent - MCP Server (TypeScript) (d365-agent-mcpserver-ts)
このリポジトリには、Model Context Protocol(MCP)サーバーの TypeScript/Node.js 実装のソースコードが含まれています。このサーバーを使用して、MCP に準拠したクライアントにさまざまなツールや機能を提供できます。
概要
d365-agent-mcpserver-ts は、AI エージェント(d365-agent-orchestrator の LangGraph で構築されたものなど)が、MCP クライアント(d365-agent-mcpclient-ts など)を介して接続するサーバーとして機能するように設計されています。Dynamics 365 やその他のバックエンドシステムに関連するツールを提供できます。
主な機能と役割
- MCP サーバーの実装: TypeScript MCP SDK(
submodules/typescript-sdk/packages/mcp-serverまたは対応する npm パッケージ)を使用して、Model Context Protocol のサーバー側要件を実装します。 - ツールの定義と公開: 開発者がカスタムツールを定義して公開できるようにします。入力/出力スキーマと実装ロジックを指定できます。
- D365 との統合(可能性/条件付き):
- Dynamics 365 との統合に使用する場合は、
d365-agent-odataclient-tsで生成された TypeScript D365 OData クライアントを利用するのが理想的です。 - 現在の状況に関する注記:
d365-agent-odataclient-tsには、D365 への接続に関する既知の問題があります。そのため、D365 固有のツールには、動作する .NET OData クライアントを使用するd365-agent-mcpserver-dotnetが、現在の D365 AI Agent アーキテクチャにおける主要かつ推奨される MCP サーバーです。
- Dynamics 365 との統合に使用する場合は、
- その他の用途: この TypeScript MCP サーバーは、以下の用途に役立ちます。
- その他の(D365 以外の)バックエンドシステム、データベース、API と連携するツールの公開。
- D365 OData アクセスを必要としないカスタムロジックや計算ツールの実装。
- 将来
d365-agent-odataclient-tsの問題が解決された場合に、軽量な MCP ツールサーバーとして利用。
- コンテナー化: デプロイ用の Docker コンテナーとしてパッケージ化できるように設計されています。
技術スタック
- TypeScript/Node.js
- HTTP トランスポート用の Web フレームワーク(例:Express、Fastify、または MCP Server SDK に組み込まれているもの)。
- D365 Agent TypeScript MCP SDK(
submodules/typescript-sdkまたはその npm パッケージ)。 - D365 に使用し、問題が解決された場合は、
d365-agent-odataclient-tsを利用する可能性があります。
インタラクションの流れ(一般的な MCP サーバー)
- MCP クライアント(例:
d365-agent-orchestratorのd365-agent-mcpclient-ts)がこのサーバーに接続します。 - クライアントは
discoverToolsを使用して、利用可能なツールとそのスキーマの一覧を取得できます。 - クライアントは、パラメーターを指定して特定のツールに対する MCP
CallToolリクエストを送信します。 d365-agent-mcpserver-tsがツールの実装ロジックを実行します。- 結果またはエラーが
McpResponseに格納され、クライアントに返されます。
はじめに
(詳細は後日追加予定です。通常は、リポジトリのクローン、Node.js/TypeScript のセットアップ、依存関係のインストール、ツールの定義、サーバーの実行が含まれます。)
開発計画の詳細については、このリポジトリの implementation.md を参照してください。
貢献
(該当する場合は、貢献ガイドラインの詳細を記載します。)
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。