Outlookmcp

🚀 Outlook日曆 MCP 服務器

這是一個 MCP（模型上下文協議）服務器，可提供對您 Outlook/微軟 365 日曆的只讀訪問。它能幫助用戶方便地獲取日曆信息，滿足特定場景下的日曆數據使用需求。

🚀 快速開始

本項目是一個提供 Outlook/微軟 365 日曆只讀訪問的 MCP 服務器。要使用該服務器，您需要完成安裝、構建、配置等步驟。下面將為您詳細介紹。

✨ 主要特性

• 提供對 Outlook/微軟 365 日曆的只讀訪問。
• 支持多種平臺的構建，包括 Windows、macOS 和 Linux。
• 可通過 YAML 配置文件或環境變量進行靈活配置。

📦 安裝指南

克隆項目

git clone https://github.com/your-username/outlookmcp.git
cd outlookmcp

下載依賴

go mod download

💻 使用示例

構建 MCP 服務器

為當前平臺構建

go build -o outlook-mcp ./cmd/mcp

交叉編譯 Windows 版本

GOOS=windows GOARCH=amd64 go build -o outlook-mcp.exe ./cmd/mcp

交叉編譯 macOS 版本

GOOS=darwin GOARCH=amd64 go build -o outlook-mcp-mac ./cmd/mcp

交叉編譯 Linux 版本

GOOS=linux GOARCH=amd64 go build -o outlook-mcp-linux ./cmd/mcp

構建 CLI 客戶端

為當前平臺構建

go build -o outlook-cli ./cmd/cli

交叉編譯 Windows 版本

GOOS=windows GOARCH=amd64 go build -o outlook-cli.exe ./cmd/cli

交叉編譯 macOS 版本

GOOS=darwin GOARCH=amd64 go build -o outlook-cli-mac ./cmd/cli

交叉編譯 Linux 版本

GOOS=linux GOARCH=amd64 go build -o outlook-cli-linux ./cmd/cli

📚 詳細文檔

項目結構

配置

配置文件

基於示例創建一個 config.yaml 文件：

outlook:
  me: "John Doe"
  max_attendees: 10
  max_event_count: 50
  skip_all_day_events: true

環境變量

創建一個包含您的 Azure AD 應用程序憑證的 .env 文件：

OUTLOOK_TENANT_ID=your-tenant-id
OUTLOOK_CLIENT_ID=your-client-id
OUTLOOK_CLIENT_SECRET=your-client-secret

🔧 技術細節

先決條件

• Go 1.21 或更高版本
• 微軟 365 賬戶，具有日曆訪問權限
• 在 Azure AD 中註冊的應用程序，並帶有適當的權限

安全注意事項

• 安全地存儲客戶端密鑰（使用環境變量）
• 服務器僅提供日曆數據的只讀訪問權限
• 沒有實現寫入操作
• 令牌僅在服務器執行期間內存中存儲