🚀 团队消息essenger

团队消息essenger（Teams Messenger）是一款基于模型上下文协议（MCP）构建的消息应用程序，它支持与微软Teams集成，具备消息收发、实时流式传输和混合搜索等功能，还通过PostgreSQL和pgvector扩展实现了先进的检索能力。

🚀 快速开始

团队消息essenger是一款强大的消息应用，能与微软Teams无缝集成，为用户提供便捷的消息交互体验。以下是快速开始使用该应用的步骤：

安装

环境要求

• 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

✨ 主要特性

• 微软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)|
+-----------------------+

此架构展示了团队消息essenger与微软Teams的交互流程。用户可以通过MCP CLI Client或Microsoft Teams与系统进行交互，系统通过Teams Graph API与微软Teams进行通信，MCP Server负责处理核心业务逻辑，IR Server (PostgreSQL) 则提供检索服务。

环境变量

💻 使用示例

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}'

📚 详细文档

• 官方文档：Teams Messenger Documentation
• 开发指南：开发者文档

❓ 常见问题

1. 无法连接Teams服务？

   • 检查API密钥是否正确
   • 确保网络连通性

2. 检索功能异常？

   • 确认PostgreSQL服务正常运行
   • 查看检索服务器日志

📞 联系方式

• 邮件：support@your-org.com
• 电话：+1 (555) 123-4567