MCP Dynamics365 Server

🚀 ダイナミックス365 MCPサーバー

Microsoft Dynamics 365 MCP Server は、Anthorpicの**Model Context Protocol(MCP)**に基づいて実装されたMCPサーバーです。このサーバーを使用すると、ユーザーはMCPプロトコルを介してMicrosoft Dynamics 365と相互作用でき、ユーザー情報やアカウントの取得、指定されたアカウントに関連する機会の取得、Claude Desktop からのアカウントの作成と更新などの機能を提供します。

このプロジェクトでは、@modelcontextprotocol/sdk ライブラリを使用してMCPサーバーとツールを実装し、Dynamics 365 APIを統合してデータ操作を行います。

🚀 クイックスタート

本サーバーを使用する前に、以下の手順に従ってセットアップしてください。

前提条件 🛠️

• 最新バージョンのNode.js（v16以上を推奨）をインストールしてください。
• Yarn または NPM（パッケージ管理用）をインストールしてください。
• 有効なDynamics 365インスタンスを設定し、必要なAPIアクセス権限を持っていることを確認してください。

設定手順

1. リポジトリのクローン

以下のコマンドを使用して、このリポジトリをローカルにクローンします。

git clone [your-repository-url]
cd dynamics-365-mcp-server

2. 依存関係のインストール

必要な依存関係をインストールするには、以下のコマンドを実行します。

• Yarnを使用する場合：

yarn install

• NPMを使用する場合：

npm install

3. 環境変数の設定

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の内容を記入してください。すべてのフィールドがあなたのDynamics 365インスタンスと一致することを確認してください。

DYNAMICS_365_URL=https://your-dynamics-365-endpoint
CLIENT_ID=your-client-id
CLIENT_SECRET=your-client-secret
TENANT_ID=your-tenant-id

4. TypeScriptファイルのコンパイル（オプション）

JavaScriptファイルを生成する場合は、以下のコマンドを実行します。

yarn build

または

npm run build

5. サーバーの起動

以下のコマンドを使用してサーバーを起動します。

yarn start

または

npm start

デフォルトでは、サーバーは http://localhost:3000 で実行されます。

✨ 主な機能

ツールリスト 🛠️

🔧 オプション：Claude Desktopとの統合

このサーバーをClaude Desktopと統合するには、以下の手順に従ってください。

1. Claude CLIのインストール

ターミナルで以下のコマンドを実行します。

pip install claude-cli

2. サーバーの登録

Claude Desktopで「接続」メニューに移動し、新しいMCPサーバーを追加します。必要なエンドポイントとその他のパラメーターを構成してください。

🐛 デバッグ

問題が発生した場合は、以下の点を確認してください。

• .env ファイルが正しく構成されていることを確認してください。
• Azure ADアプリケーションがDynamics 365 APIにアクセスするための必要なアクセス許可を持っていることを確認してください。
• あなたの環境がDynamics 365インスタンスにアクセスできることを確認してください。

また、問題を追跡するために、コードにデバッグログを追加することもできます。例えば：

console.error("デバッグ：読み込まれた環境変数:", process.env);

🤝 コントリビューション

コントリビューションを歓迎します！ 自由にプルリクエストを送信するか、問題を報告して、エラーや機能要求を通知してください。

コントリビュートするには：

• このリポジトリをフォークします。
• 新しいブランチを作成して、あなたの機能や修正を加えます。
• 変更をコミットして、プルリクエストを送信します。
• あなたの貢献に感謝します！ 😊

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。