MCP Microsoft Office

🚀 Microsoft 365 MCP Gateway

Microsoft 365 Modular Customization Platform (MCP) is a modular platform that enables in - depth customization within Microsoft Teams. It allows custom features to be added as independent components, facilitating flexible feature expansion.

🚀 Quick Start

Create a New Module

1. Create a modules folder in the project root directory.
2. Create a new module.cjs file with the following content:

   exports.name = 'ModuleName';
   exports.version = '1.0.0';
   exports.description = 'Module Description';
   

3. Register the module in mcp - adapter.cjs:

   moduleRegistry.register(modulePath);
   

Configure the Module

Configure through a YAML file, for example:

modules:
  - name: ModuleName
    enabled: true
    config:
      option1: value1
      option2: value2

✨ Features

• Modular Architecture: All features are built as independent modules for easy management and maintenance.
• Plugin Support: Supports plugins in various formats, including TypeScript and JavaScript.
• Deep Integration: Natively integrated with Microsoft Teams, providing rich API support.
• Flexible Configuration: Function configuration can be achieved through YAML files without modifying the code.

📦 Installation

Prerequisites

1. Node.js (version 14 or higher)
2. npm (version 6 or higher)
3. Microsoft Teams account

Installation Steps

1. Clone the project repository:

   git clone https://github.com/ microsoft/mcp.git
   cd mcp
   

2. Install dependencies:

   npm install
   

3. Start the service:

   npm start
   

📚 Documentation

Add New Features

1. Create a new service class.
2. Implement the required interfaces.
3. Register the service in mcp - adapter.cjs.

Testing Guide

# Run all tests
npm test

# Run unit tests
npm run test:unit

# Run integration tests
npm run test:integration

💻 Usage Examples

Basic Usage

// Create a new module
exports.name = 'ModuleName';
exports.version = '1.0.0';
exports.description = 'Module Description';

// Register the module
moduleRegistry.register(modulePath);

// Configure the module
modules:
  - name: ModuleName
    enabled: true
    config:
      option1: value1
      option2: value2

Advanced Usage

# Run different types of tests
# Run all tests
npm test

# Run unit tests
npm run test:unit

# Run integration tests
npm run test:integration

🔧 Technical Details

Project Structure

/
├── mcp - adapter.cjs           # MCP Gateway implementation
├── dev - server.cjs            # Express server - side
├── data/
│   └── mcp.sqlite            # SQLite database for authentication
├── src/
│   ├── api/                  # API endpoints
│   │   ├── controllers/      # Request handlers
│   │   └── routes.cjs        # Route definitions
│   ├── core/                 # Core services
│   │   ├── auth - service.cjs  # Authentication
│   │   ├── storage - service.cjs # Data storage
│   │   └── tools - service.cjs # Tool definitions
│   ├── graph/                # Microsoft Graph integration
│   │   ├── graph - client.cjs  # Graph client
│   │   ├── mail - service.cjs  # Mail operations
│   │   ├── calendar - service.cjs # Calendar operations
│   │   ├── files - service.cjs # File operations
│   │   └── people - service.cjs # People/Contact operations
│   └── normalizers.cjs      # Data normalization
└── test/                     # Tests
    ├── unit/                 # Unit tests
    └── integration/          # Integration tests

Design Principles

• Asynchronous Operations: All operations use async/await to ensure good response performance.
• Error Handling: Unified error creation, logging, and recovery mechanisms.
• Modular Architecture: Independent module design for easy expansion and maintenance.
• Configurability: Flexible function adjustment through configuration files.

📄 License

No license information provided in the original document.

⚠️ Important Note

1. Ensure that all dependencies are installed correctly.
2. Conduct thorough testing before the production environment.
3. Follow Microsoft's security specifications to ensure data security.

With the above guide, you can easily get started with the Microsoft 365 Modular Customization Platform and expand the features of Teams according to your needs.