MCP Microsoft Office

🚀 微軟 365 MCP 門徑

Microsoft 365 Modular Customization Platform (MCP) 是一個模塊化平臺，允許在 Microsoft Teams 中進行深度定製。通過將自定義功能以獨立組件的形式添加到 Teams 中，可實現靈活的功能擴展。

🚀 快速開始

Microsoft 365 Modular Customization Platform (MCP) 能讓你在 Microsoft Teams 裡進行深度定製。下面為你介紹如何快速上手。

創建新模塊

1. 在項目根目錄創建 modules 文件夾。
2. 新建一個 module.cjs 文件，內容如下：

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

3. 在 mcp-adapter.cjs 中註冊模塊：

   moduleRegistry.register(modulePath);
   

配置模塊

通過 YAML 文件進行配置，例如：

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

✨ 主要特性

• 模塊化架構：所有功能均以獨立模塊形式構建，便於管理和維護。
• 插件支持：支持多種格式的插件，包括 TypeScript 和 JavaScript。
• 深度集成：與 Microsoft Teams 原生集成，提供豐富的 API 支持。
• 靈活配置：通過 YAML 文件實現功能配置，無需修改代碼即可完成。

📦 安裝指南

必要條件

1. Node.js（版本 14 或更高）
2. npm（版本 6 或更高）
3. Microsoft Teams 賬戶

安裝步驟

1. 克隆項目倉庫：

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

2. 安裝依賴：

   npm install
   

3. 啟動服務：

   npm start
   

📚 詳細文檔

開發指南

添加新功能

1. 創建新的服務類。
2. 實現所需接口。
3. 在 mcp-adapter.cjs 中註冊服務。

測試指南

# 運行所有測試
npm test

# 運行單元測試
npm run test:unit

# 運行集成測試
npm run test:integration

項目結構

/
├── mcp-adapter.cjs           # MCP 門徑實現
├── dev-server.cjs            # Express 服務器端
├── data/
│   └── mcp.sqlite            # SQLite 數據庫用於身份驗證
├── src/
│   ├── api/                  # API 端點
│   │   ├── controllers/      # 請求處理程序
│   │   └── routes.cjs        # 路由定義
│   ├── core/                 # 核心服務
│   │   ├── auth-service.cjs  # 身份驗證
│   │   ├── storage-service.cjs # 數據存儲
│   │   └── tools-service.cjs # 工具定義
│   ├── graph/                # Microsoft Graph 集成
│   │   ├── graph-client.cjs  # 圖形客戶端
│   │   ├── mail-service.cjs  # 郵件操作
│   │   ├── calendar-service.cjs # 日曆操作
│   │   ├── files-service.cjs # 文件操作
│   │   └── people-service.cjs # 人員/聯繫人操作
│   └── normalizers.cjs      # 數據標準化
└── test/                     # 測試
    ├── unit/                 # 單元測試
    └── integration/          # 集成測試

設計原則

• 異步操作：所有操作均使用 async/await，確保良好的響應性能。
• 錯誤處理：統一的錯誤創建、日誌記錄和恢復機制。
• 模塊化架構：獨立的模塊設計，便於擴展和維護。
• 可配置性：通過配置文件實現功能靈活調整。

⚠️ 注意事項

⚠️ 重要提示

1. 確保所有依賴項已正確安裝。
2. 在生產環境前進行充分測試。
3. 遵循微軟的安全規範，確保數據安全。

通過以上指南，您可以輕鬆上手 Microsoft 365 Modular Customization Platform，並根據需求擴展 Teams 的功能。