Copilot Studio Server

Microsoft Copilot Studio에서 사용할 수 있는 예제 MCP 서버입니다.
Python과 공식 MCP Python SDK를 사용하며, 아래 두 도구를 제공합니다.

• echo: 입력한 문장을 3번 반복
• multi: 입력한 숫자를 제곱

기술 기준

• 언어: Python
• SDK: mcp[cli]
• 전송 방식: Streamable HTTP
• 권장 실행 구성: stateless_http=True, json_response=True

파일 구성

.
├─ server.py
├─ pyproject.toml
├─ README.md
├─ CUSTOM_INSTRUCTIONS.md
└─ MCP_SERVER_REQUIREMENTS.md

요구 사항

• Python 3.10 이상
• Copilot Studio에서 MCP를 사용하려면 Generative orchestration이 활성화되어 있어야 함

설치

uv 사용

uv sync

pip 사용

pip install "mcp[cli]>=1.9.0"

실행

python server.py

서버는 MCP Streamable HTTP 방식으로 실행됩니다.
기본 경로는 일반적으로 /mcp를 사용합니다.

PowerShell 빠른 실행

프로젝트 폴더에서 아래 스크립트로 실행할 수 있습니다.

.\start_mcp_server.ps1

중지할 때는 아래 스크립트를 사용합니다.

.\stop_mcp_server.ps1

PowerShell 실행 정책 때문에 .ps1 실행이 막히면 아래 .cmd 파일을 사용합니다.

.\start_mcp_server.cmd
.\stop_mcp_server.cmd

start_mcp_server.cmd는 새 PowerShell 창을 열어 서버를 실행하므로, 그 창이 열려 있는 동안 MCP 서버가 유지됩니다.

도구 설명

1. echo

• 설명: 입력된 문장을 정확히 3번 반복해서 반환
• 입력:

{
  "message": "안녕하세요"
}

• 출력:

"안녕하세요 안녕하세요 안녕하세요"

2. multi

• 설명: 입력된 숫자를 제곱해서 반환
• 입력:

{
  "number": 5
}

• 출력:

25

Copilot Studio 연결 개요

1. Copilot Studio에서 에이전트를 연다.
2. Generative orchestration이 활성화되어 있는지 확인한다.
3. MCP 서버 추가 화면에서 이 서버의 URL을 등록한다.
4. 연결 후 echo, multi 도구가 자동으로 표시되는지 확인한다.

참고

• Copilot Studio는 MCP 서버의 도구 이름, 설명, 입력, 출력을 자동 반영한다.
• Copilot Studio는 Streamable transport를 지원한다.
• SSE는 Copilot Studio에서 2025년 8월 이후 지원되지 않는다.