MCP Teams

🚀 チームメッセンジャー

チームメッセンジャーは、モデルコンテキストプロトコル（MCP）に基づいて構築されたメッセージアプリケーションです。Microsoft Teamsとの統合をサポートし、メッセージの送受信、リアルタイムストリーミング、ハイブリッド検索機能を提供します。また、PostgreSQLとpgvector拡張機能を使用して、高度な検索能力を実現しています。

✨ 主な機能

• Microsoft Teams統合：Microsoft Graph APIを通じてTeamsメッセージのやり取りを実現します。
• リアルタイムストリーミング：messages/incomingイベントをサブスクライブすることで、リアルタイムの更新を取得できます。
• ハイブリッド検索：BM25とベクトル検索を組み合わせ、LLMによる再ランキングをサポートします。
• DuckDBとPostgreSQLのサポート：DuckDBを使用してローカルストレージを行い、PostgreSQLを使用して拡張検索を行います。
• コマンドラインインターフェイス（CLI）：完全なMCPプロトコルのやり取り能力を提供します。

🔧 技術詳細

+-------------------+       +---------------------+
| Microsoft Teams  |       | MCP CLI Client      |
+-------------------+       +---------------------+
          △                 |
          |                 △
+-----------------------+  △
|   Teams Graph API    |
+-----------------------+
          |
          ↓
+-----------------------+
| MCP Server            |
+-----------------------+
          |
          ↓
+-----------------------+
| IR Server (PostgreSQL)|
+-----------------------+

📦 インストール

環境要件

• Python 3.8以上のバージョン
• DockerとDocker Compose
• PostgreSQL 14以上のバージョン

クイックインストール

# リポジトリをクローンする
git clone https://github.com/your-org/teams-messenger.git
cd teams-messenger

# 依存関係をインストールする
pip install -r requirements.txt

# 環境変数を設定する
export MS_GRAPH_API_KEY="your-key"
export MCP_SERVER_PORT=5000
export IR_SERVER_URL=http://localhost:8090

環境変数

💻 使用例

基本的な使用法

MCPサービスの起動

# 単独でMCPサービスを起動する
python mcp_server.py

# Docker-composeを使用してすべてのサービスを起動する
docker-compose up -d

コンソールへのアクセス

• MCP管理画面：http://localhost:5000
• 検索サーバー：http://localhost:8090

高度な使用法

CLIの使用

ログインとトークン管理

python cli/login.py login    # ユーザーログイン
python cli/login.py status   # ログイン状態を確認する
python cli/login.py logout   # ユーザーログアウト

メッセージ操作

python cli/mcp_client.py list_chats        # すべてのチャットをリストする
python cli/mcp_client.py get_messages <id>  # 指定されたチャットのメッセージを取得する
python cli/mcp_client.py send_message <id> "メッセージ内容"  # 新しいメッセージを送信する

新しいチャットの作成

python cli/mcp_client.py create_chat <ユーザーIDまたはメールアドレス>

検索機能

python cli/mcp_client.py search_messages "検索キーワード" --mode hybrid --top_k 5

検索サーバーの使用法

ヘルスチェック

curl http://localhost:8090/

ツールのリスト

curl GET http://localhost:8090/api/tools

コンテンツ検索

curl POST http://localhost:8090/api/tools/search \
  -H "Content-Type: application/json" \
  -d '{"query":"検索内容","search_type":"hybrid","top_k":5}'

📚 ドキュメント

よくある質問

1. Teamsサービスに接続できない場合

   • APIキーが正しいか確認してください。
   • ネットワーク接続が正常か確認してください。

2. 検索機能が正常に動作しない場合

   • PostgreSQLサービスが正常に動作していることを確認してください。
   • 検索サーバーのログを確認してください。

プロジェクトドキュメント

• 公式ドキュメント：Teams Messenger Documentation
• 開発ガイド：開発者ドキュメント

連絡先

• メール：support@your-org.com
• 電話：+1 (555) 123-4567