Agent-Dev MCP Server

The Agent-Dev MCP Server is a Model Context Protocol (MCP) server that provides a seamless connection between AI agents and developers for building apps and agents for Microsoft 365 and Microsoft 365 Copilot.

Overview

What can you do with it?

Agent-Dev MCP Server is designed to help you:

• Build and deploy AI agents for Microsoft 365
• Integrate with Microsoft 365 Copilot features
• Access and manage app and agent templates
• Troubleshoot common issues effectively

Currently Supported Tools

• Schema Fetcher for:
  • App Manifest
  • Declarative Agent Manifest
  • API Plugin Manifest
• Microsoft 365 and Microsoft 365 Copilot Knowledge Retriever
• Apps and Agents Samples and Templates Code Snippets Retriever
• Troubleshooting Retriever

Prerequisites

1. The Agent-Dev MCP Server requires Node.js to install and run the server. If you don't have it installed, follow the instructions here.
2. Install either the stable or Insiders release of VS Code:
   • 💫 Stable release
   • 🔮 Insiders release
3. Install the GitHub Copilot and GitHub Copilot Chat extensions

Installation

Manual Install

For a step-by-step guide to install the Agent-Dev MCP Server, follow these instructions:

• Add .vscode/mcp.json:

  {
      "servers": {
          "Agent-Dev Server": {
              "command": "npx",
              "args": [
                  "-y",
                  "@zihch/agent-dev-mcp@latest",
                  "server",
                  "start"
              ]
          }
      }
  }

Install From Command Palette

List The Tools

• Open GitHub Copilot in VS Code and switch to Agent mode

• Click refresh on the tools list.

For Visual Studio

Manual configuration required, please follow: Visual Studio MCP Official Guide

Local Development

To run and test the Agent-Dev MCP Server locally:

1. Clone and Install Dependencies

git clone https://github.com/zihch_microsoft/agent-dev-mcp.git
cd agent-dev-mcp
npm install --legacy-peer-deps

2. Build the Project

npm run build

This will create a dist/ folder with the compiled server.

3. Run Tests

npm run test:unit

4. Configure Local MCP in VS Code

Create or update .vscode/mcp.json in your workspace:

{
  "servers": {
    "Agent-Dev Server (Local)": {
      "command": "node",
      "args": [
        "/path/to/agent-dev-mcp/dist/index.js"
      ]
    }
  }
}

Replace /path/to/agent-dev-mcp with the actual path to your cloned repository.

5. Test the MCP

1. Restart VS Code or reload the window (Cmd/Ctrl+Shift+P → "Reload Window")
2. Open GitHub Copilot Chat
3. Switch to Agent mode
4. Click the refresh button on the tools list
5. You should see "Agent-Dev Server (Local)" with 4 tools available

Available Scripts

• npm run build - Build production bundle
• npm run build:dev - Build development bundle
• npm run watch - Watch mode for development
• npm start - Run the built server
• npm run test:unit - Run unit tests
• npm run lint - Lint the code
• npm run lint:fix - Fix linting issues

Feedback

We're building this in the open. Your feedback is much appreciated, and will help us shape the future of the Agent-Dev MCP Server.

• Open an issue in the public repository.
• Send an email to [email protected] to chat with the product team.

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

License

Copyright (c) Microsoft Corporation. All rights reserved.

Licensed under the MIT license.