TY

taiki-yoshida/copilot-studio-code

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

22 stars 3 forks 품질 56 트렌드 10MIT

Local MCP server plus an importable Copilot Studio solution that gives a Microsoft Copilot Studio agent Claude-Code-style file and shell tools.

개요

A local MCP server that gives a Microsoft Copilot Studio agent Claude-Code-style tools against your local filesystem and shell — read, edit, search, and run commands from the Copilot Studio test canvas. Ships with an importable Copilot Studio solution so you can stand up a working agent in minutes. How the mode is chosen, in order of precedence: 1. SAFETY env var (strict / moderate / open) 2. --safety CLI flag 3. Interactive prompt at startup (10s timeout → moderate) All write_file, edit_file, and run_shell calls are appended to /.copilotstudio-mcp/audit.log. Copilot Studio is cloud-hosted, so it cannot reach localhost. Use to expose the server over HTTPS. devtunnel host prints a public URL like https:// -8787.usw2.devtunnels.ms. Leave it running. Drop --allow-anonymous and the tunnel will require an MS account on the Copilot Studio side. Recommended once you have it working. Two ways: import the prebuilt solution (fastest), or configure an agent manually.

README

원문 README의 일부입니다. 원문 보기.

copilot-studio-code

A local MCP server that gives a Microsoft Copilot Studio agent Claude-Code-style tools against your local filesystem and shell — read, edit, search, and run commands from the Copilot Studio test canvas. Ships with an importable Copilot Studio solution so you can stand up a working agent in minutes.

Tools exposed

Tool Purpose
read_file Read a UTF-8 text file.
write_file Create or overwrite a file.
edit_file Exact-match string replace (unique-match required, or replace_all=true).
list_dir List entries in a directory.
glob Find files matching a glob pattern.
grep Regex search across files (skips node_modules, .git, dist).
run_shell Execute a shell command (PowerShell on Windows, bash elsewhere). Disabled in strict mode.

Safety modes (selected at startup)

Mode Path jail run_shell
strict enforced disabled
moderate (default) enforced enabled, audit-logged
open off enabled, audit-logged

How the mode is chosen, in order of precedence:

  1. SAFETY env var (strict / moderate / open)
  2. --safety CLI flag
  3. Interactive prompt at startup (10s timeout → moderate)

All write_file, edit_file, and run_shell calls are appended to /.copilotstudio-mcp/audit.log.

Run it

npm install
npm start

The server prints something like:

copilot-studio-code MCP server
  workspace root : E:\Dev\projects\my-project
  safety mode    : moderate
  listening on   : http://localhost:8787/mcp
  health check   : http://localhost:8787/healthz

Override the workspace it operates on:

$env:WORKSPACE_ROOT = "E:\Dev\some-other-project"; npm start

Wiring it into Copilot Studio

Copilot Studio is cloud-hosted, so it cannot reach localhost. Use Microsoft Dev Tunnels to expose the server over HTTPS.

1. Install and log in to dev tunnels

winget install Microsoft.devtunnel
devtunnel user login

2. Create a persistent tunnel for port 8787

devtunnel create copilotstudio-mcp --allow-anonymous
devtunnel port create copilotstudio-mcp -p 8787 --protocol http
devtunnel host copilotstudio-mcp

devtunnel host prints a public URL like https://-8787.usw2.devtunnels.ms. Leave it running.

Drop --allow-anonymous and the tunnel will require an MS account on the Copilot Studio side. Recommended once you have it working.

3. Wire the MCP server into a Copilot Studio agent

Two ways: import the prebuilt solution (fastest), or configure an agent manually.

Path A — Import the prebuilt solution

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →