mcp-server-conversation-agents

🚀 🤖 Dialogflow CX MCP 服务器 💡

这是一个用于管理 Dialogflow CX 会话的 MCP 服务器，支持多种交互方式，还能与 webhook 集成，极大地提升了对话管理的灵活性和便捷性。

🚀 快速开始

要快速启动该服务，可按以下步骤操作：

1. 完成项目安装（具体安装步骤见“📦 安装指南”）。
2. 进行配置（具体配置说明见“🛠️ 配置说明”）。
3. 启动服务：

python3 server.py

4. 进行示例交互：
   • 文本输入

   curl -X POST http://localhost:5005/api/conversations \
   -H "Content-Type: application/json" \
   -d '{"text": "你好", "session_id": "user_123"}'
   

   • 音频处理

   curl -X POST http://localhost:5005/api/audio \
   -H "Content-Type: audio/wav" \
   -d '@/path/to/audio.wav'
   

✨ 主要特性

🌟 核心功能

• 意图匹配：能够通过文本或音频输入精准识别用户意图。
• 上下文管理：有效维护对话状态，实时处理参数更新。
• 多轮对话：支持复杂的交互流程，确保会话的连贯性。
• webhook 集成：可与第三方服务实现无缝对接。

🎯 扩展功能

• 自定义规则：可以灵活配置意图路由和参数处理逻辑。
• 日志跟踪：详细记录每一步操作，方便进行调试和分析。
• 状态恢复：支持断线重连，确保会话不会中断。

📦 安装指南

🌐 环境要求

• 操作系统：Linux/MacOS/Windows（推荐使用 Linux）
• Python 版本：3.8 或以上版本
• 依赖管理工具：pip

💽 项目安装

git clone https://github.com/your-repository.git
cd mcp-server
pip install -r requirements.txt

🛠️ 配置说明

将以下内容添加到 config.yaml 文件中：

server:
  host: '0.0.0.0'
  port: 5005
  
dialogflow:
  project_id: 'your-project-id'
  private_key_path: './path/to/service-account.json'
  
webhook:
  enable: true
  url: 'https://api.your-domain.com/webhook'

💻 使用示例

基础用法

以下是通过文本输入和音频处理与服务器进行交互的示例：

• 文本输入

curl -X POST http://localhost:5005/api/conversations \
-H "Content-Type: application/json" \
-d '{"text": "你好", "session_id": "user_123"}'

• 音频处理

curl -X POST http://localhost:5005/api/audio \
-H "Content-Type: audio/wav" \
-d '@/path/to/audio.wav'

📄 响应格式

💡 示例响应

{
  "messages": [
    {
      "type": "text",
      "content": "欢迎光临！有什么我可以帮您的吗？"
    }
  ],
  "intent": {
    "name": "greeting",
    "confidence": 0.95
  },
  "parameters": {
    "user_name": "John"
  },
  "current_page": "WelcomePage",
  "session_id": "user_123",
  "end_interaction": false
}

🤝 共同开发

🌟 贡献指南

• 问题反馈：Issues
• 代码提交：Pull Request

🚀 提升计划

• [ ] 支持更多语言模型（如 LLM）
• [ ] 增加可视化管理界面
• [ ] 优化日志系统

🔥 联系我们

• 邮箱：contact@your-domain.com
• Discord：加入社区

开源不易，如果你觉得这个项目有帮助，请考虑给我们一个星星 ⭐😊