Farzad528 MCP Server Azure Ai Agents

🚀 Azure AIエージェントサービス + Azure AI検索MCPサーバー

このプロジェクトは、モデルコンテキストプロトコル（MCP）サーバーを提供し、Claude DesktopがAzure AIサービスを使用してコンテンツを検索できるようにします。Azure AIエージェントサービス（ドキュメント検索とウェブ検索を含む）を選択するか、直接統合されたAzure AI検索を使用することができます。

🚀 クイックスタート

このプロジェクトは、Claude DesktopをAzure検索機能に接続するための2種類のMCPサーバー実装を提供します。

✨ 主な機能

• 複数の検索モードをサポート：インデックスベース、ウェブ、および混合検索
• 検索動作を調整するための構成可能なツール命令
• 柔軟な応答形式オプション
• 拡張性が高く、新機能を簡単に追加できる
• 中国語と英語のバイリンガルサポート

📦 インストール

1. Python環境のインストール

Python 3.8以上がインストールされていることを確認し、pipをインストールします。

python --version
pip install --upgrade pip

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

Azure AIエージェントサービスの場合：

uv pip install "mcp[cli]" azure-core==1.5.0 python-dotenv

直接Azure AI検索の場合：

uv pip install "mcp[cli]" azure-search-documents==11.5.2 python-dotenv

3. プロジェクトコードのダウンロード

GitHubからリポジトリをクローンします：

git clone https://github.com/your-organization/azure-ai-mcp.git
cd azure-ai-mcp

📚 ドキュメント

構成説明

Azure AIエージェントサービスの構成

env_agent_serviceファイルを作成し、以下の内容を追加し、実際の情報に置き換えます：

AZURE_AI_SUBSCRIPTION_ID=your-subscription-id
AZURE_AI_ENDPOINT=https://your-region.api.cognitive.microsoft.com

直接Azure AI検索の構成

env_search_serviceファイルを作成し、以下の内容を追加し、実際の情報に置き換えます：

AZURE_SEARCH_SERVICE_ENDPOINT=https://your-service-name.search.windows.net
AZURE_SEARCH_INDEX_NAME=your-index-name
AZURE_SEARCH_API_KEY=your-api-key

使用方法

サーバーの起動

Azure AIエージェントサービスの場合：

uv run python server.py

直接Azure AI検索の場合：

uv run python search_server.py

Claude Desktopでの構成

以下の内容をClaudeの構成ファイルに追加します：

Azure AIエージェントサービスの構成：

{
  "mcpServers": {
    "azure-agent-service": {
      "command": "C:\\路径\\to\\venv\\Scripts\\python.exe",
      "args": ["C:\\路径\\to\\server.py"],
      "env": {
        "AZURE_AI_SUBSCRIPTION_ID": "your-subscription-id",
        "AZURE_AI_ENDPOINT": "https://your-region.api.cognitive.microsoft.com"
      }
    }
  }
}

直接Azure AI検索の構成：

{
  "mcpServers": {
    "azure-search-service": {
      "command": "C:\\路径\\to\\venv\\Scripts\\python.exe",
      "args": ["C:\\路径\\to\\search_server.py"],
      "env": {
        "AZURE_SEARCH_SERVICE_ENDPOINT": "https://your-service-name.search.windows.net",
        "AZURE_SEARCH_INDEX_NAME": "your-index-name",
        "AZURE_SEARCH_API_KEY": "your-api-key"
      }
    }
  }
}

示例用法

Claude Desktopで以下のクエリを入力します：

• Azure AI検索ツールを使用する：
  • "私のAzureインデックス内のAI関連情報を検索する"
• 必应ウェブ検索ツールを使用する：
  • "ウェブ上で大規模言語モデルの最新の開発を検索する"
• 混合検索ツールを使用する：
  • "ディープラーニングに関する研究論文を検索する"

よくある質問

サーバーが表示されない場合

1. Claude Desktopのログ（%APPDATA%\Claude\logs\mcp*.logにあります）を確認します。
2. ファイルパスと環境変数の構成が正しいことを確認します。
3. サーバーを直接実行してテストします：python server.py

Azure AIエージェントサービスの問題

1. Azure AIプロジェクトが正しく構成されていることを確認します。
2. 接続が存在し、構成が正しいことを検証します。
3. Azureの認証状態を確認します。

カスタマイズオプション

• ツール命令の変更 - 各エージェントの命令を調整して、クエリの処理方法を変更します。
• 新機能の追加 - @mcp.tool()デコレータを使用して、より多くの機能を統合します。
• 応答形式のカスタマイズ - Claude Desktopが応答を返す方法を編集します。
• ウェブ検索パラメータの調整 - 必应検索ツールの注目分野を変更します。

📄 ライセンス

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