Azure AI 에이전트 서비스 MCP 서버

이 MCP 서버는 Azure AI Foundry와 통합되어 기존 Azure AI 에이전트에 대한 연결을 지원하고 Azure AI Foundry에서 제공하는 Azure AI Search 및 Bing Web Grounding과 같은 다양한 모델과 지식 도구를 활용합니다.

특징

🤖 에이전트 통합 - 기존 Azure AI 에이전트에 연결
🔄 원활한 워크플로 - 모든 MCP 클라이언트 내에서 에이전트를 직접 사용하세요
🛡️ 보안 - 모든 연결에서 Azure 자격 증명을 사용합니다.
🧠 대화 메모리 - 각 클라이언트 세션은 분리된 대화 기록을 유지합니다.

도구

연결_에이전트
- ID로 특정 Azure AI Agent에 연결
- 입력:
  - agent_id (문자열): 연결할 Azure AI Agent의 ID
  - query (문자열): 에이전트에게 보낼 질문이나 요청
  - thread_id (문자열, 선택 사항): 대화 지속을 위한 스레드 ID
- 반환: 에이전트의 형식화된 응답
쿼리_기본_에이전트
- 기본 구성된 에이전트에 쿼리를 보냅니다.
- 입력:
  - query (문자열): 에이전트에게 보낼 질문이나 요청
  - thread_id (문자열, 선택 사항): 대화 지속을 위한 스레드 ID
- 반환: 기본 에이전트의 형식화된 응답
목록_에이전트
- 프로젝트에서 사용 가능한 모든 Azure AI 에이전트를 나열하세요.
- 반환: ID와 이름이 포함된 사용 가능한 에이전트 목록

구성

Azure 설정

Azure AI Foundry를 통해 Azure AI 에이전트 만들기
Azure AI 프로젝트 연결 문자열을 기록하세요.
에이전트 ID를 기록해 두세요(특정 에이전트에 연결하려면 이 ID가 필요합니다)
Azure 자격 증명을 사용하여 인증: az login

환경 변수

이 서버에는 다음과 같은 환경 변수가 필요합니다.

지엑스피1

설치

필수 조건

파이썬 3.10+
Azure CLI (az) 설치 및 구성
원하는 기능을 갖춘 기존 Azure AI 에이전트

설정

# Setup environment
python -m venv .venv
.venv\Scripts\activate  # On Windows
source .venv/bin/activate  # On macOS/Linux

# Install dependencies
pip install mcp[cli] azure-identity python-dotenv azure-ai-projects aiohttp

# Run server directly (from ./src/python)
python -m azure_agent_mcp_server

uv를 사용하는 것을 선호하는 경우:

# Setup environment with uv
uv venv
.venv\Scripts\activate  # On Windows
source .venv/bin/activate  # On macOS/Linux

# Install dependencies
uv add mcp[cli] azure-identity python-dotenv azure-ai-projects aiohttp

# Run server (F)
uv run -m azure_agent_mcp_server

Claude Desktop과 함께 사용

Claude Desktop과 함께 사용하려면 구성 파일에 다음을 추가하세요.

{
  "mcpServers": {
    "azure-agent": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
        "run",
        "-m",
        "azure_agent_mcp_server"
      ],
      "env": {
        "PROJECT_CONNECTION_STRING": "your-project-connection-string",
        "DEFAULT_AGENT_ID": "your-default-agent-id"
      }
    }
  }
}

uv 사용하고 싶지 않다면 python을 사용할 수 있습니다:

{
  "mcpServers": {
    "azure-agent": {
      "command": "python",
      "args": [
        "-m",
        "azure_agent_mcp_server"
      ],
      "cwd": "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
      "env": {
        "PYTHONPATH": "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
        "PROJECT_CONNECTION_STRING": "your-project-connection-string",
        "DEFAULT_AGENT_ID": "your-default-agent-id"
      }
    }
  }
}

다른 MCP 클라이언트와 함께 사용

이 서버는 MCP 프로토콜 사양을 따르며 모든 MCP 호환 클라이언트와 함께 사용할 수 있습니다. 외부 MCP 서버에 연결하는 방법에 대한 자세한 내용은 클라이언트 설명서를 참조하십시오.

개발 노트

이 프로젝트는 Python 디렉터리에 있는 Python 코드를 사용하는 다국어 구조를 따릅니다. 실행 또는 개발 시:

항상 프로젝트 루트에서 가상 환경을 활성화하세요
Python 명령을 실행할 때 Python 디렉토리로 이동합니다.
패키지 설치를 위해 pyproject.toml이 있는 Python 디렉토리에 있는지 확인하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

모든 MCP 클라이언트 내에서 Azure AI 에이전트에 대한 연결을 지원하여 사용자가 대화형 인터페이스를 통해 Azure AI Foundry의 모델과 Azure AI 검색 및 Bing 웹 그라운딩과 같은 지식 도구를 활용할 수 있도록 합니다.

Azure AI Agent Service MCP Server