
taiki-yoshida/copilot-studio-code
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
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:
SAFETYenv var (strict/moderate/open)--safetyCLI flag- 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-anonymousand 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
설치
This server does not publish a one-line install command.
Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →