Outlookmcp

🚀 OutlookカレンダーMCPサーバ

このサーバは、Outlook/マイクロソフト365カレンダーへの読み取り専用アクセスを提供するMCP（モデルコンテキストプロトコル）サーバです。

🚀 クイックスタート

前提条件

• Go 1.21以上
• カレンダーアクセス権限を持つマイクロソフト365アカウント
• Azure ADで登録され、適切な権限を持つアプリケーション

プロジェクト構造

• outlook/outlook_api.go - Outlookカレンダーとのやり取りに使用する内部API
• cmd/mcp/main.go - AIアシスタント用のMCPサーバの実装
• cmd/cli/main.go - テスト用のコマンドラインインターフェース
• config.example.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

設定

設定方法は2種類あります。

1. YAML設定ファイルを使用する（config.example.yamlを参照）
2. 環境変数を使用する

設定ファイル

サンプルを元に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

セキュリティに関する注意事項

• クライアントシークレットを安全に保管する（環境変数を使用）
• サーバはカレンダーデータの読み取り専用アクセスのみを提供する
• 書き込み操作は実装されていない
• トークンはサーバ実行中にのみメモリに保存される