MCP Client Distributor Chat

🌐 MCP客户-经销商聊天

*现代人工智能工作流的终极模型上下文协议客户端*

🚀 Quick Start • ✨ Features • 🎮 Demo • 📦 Installation • 📚 Docs

______________________________________________________________________

🎯 概述

MCP客户-经销商聊天 是一个全面的 模型上下文协议（MCP） 客户端应用程序，可实现与多个MCP服务器的无缝连接以及与AI代理的交互式通信。采用现代Gradio界面构建，由 smolagents，它为各种用例提供了简单和高级的实现。

🔍 What is MCP? (Click to expand)

这 模型上下文协议（MCP） 是一个开放标准，使人工智能应用程序能够安全地连接到数据源和工具。它为AI助手提供了一种统一的方式，通过标准化的协议与各种服务、数据库和API进行交互。

✨ 特性

🔌 多服务器管理

• 同时连接到多个MCP服务器
• 实时连接状态监控
• 自定义服务器添加和配置
• 自动故障切换和重新连接

🤖 AI代理交互

• 与智能代理进行交互式聊天
• 访问特定于服务器的工具和功能
• 上下文感知对话
• 多回合对话支持

📊 高级分析

• 对话历史跟踪
• 服务器性能指标
• 连接日志和诊断
• 使用统计数据和见解

🎨 现代界面

• 基于Gradio的响应式用户界面
• 黑暗/光明主题支持
• 实时更新
• 移动友好型设计

🎮 演示

🌟 现场演示可用

🚀 快速开始

1.️⃣ 克隆存储库

git clone https://github.com/AdilzhanB/MCP-Client-distributor-chat.git
cd MCP-Client-distributor-chat

2.️⃣ 再进行

pip install -r requirements.txt

3.️⃣ 设置环境变量

export HF_TOKEN="your_huggingface_token_here"

4.️⃣ 运行应用程序

# Simple version (recommended for beginners)
python mcp_client_simple.py

# Advanced version (full features)
python mcp_client_advanced.py

📦 安装

🐍 Python要求

📋 Dependencies

gradio[mcp]>=4.44.0
smolagents[mcp]>=0.3.0
mcp>=1.0.0
fastmcp>=0.1.0
huggingface-hub>=0.19.0
textblob>=0.17.1

🔧 开发设置

# Create virtual environment
python -m venv mcp_env
source mcp_env/bin/activate  # On Windows: mcp_env\Scripts\activate

# Install in development mode
pip install -e .

# Install development dependencies
pip install -r requirements-dev.txt

🐳 Docker支持

FROM python:3.10-slim

WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt

COPY . .
EXPOSE 7860

CMD ["python", "mcp_client_simple.py"]

🏗️ 建筑

graph TB
    A[🌐 Gradio UI] --> B[🔌 MCP Client Manager]
    B --> C[📡 Server Connection Pool]
    C --> D[🖥️ MCP Server 1]
    C --> E[🖥️ MCP Server 2]
    C --> F[🖥️ MCP Server N]
    
    B --> G[🤖 Agent Manager]
    G --> H[💬 Chat Interface]
    G --> I[🔧 Tool Executor]
    
    B --> J[📊 Analytics Engine]
    J --> K[📈 Metrics Collector]
    J --> L[📚 History Manager]
    
    style A fill:#667eea
    style B fill:#764ba2
    style G fill:#f093fb
    style J fill:#f5576c

📚 文档

🔧 api参考

📖 MCP Client API

MCPClient 类

class AdvancedMCPClient:
    async def connect_to_server(self, server_name: str) -> tuple[bool, str]
    async def chat_with_agent(self, message: str, server_name: str) -> str
    def add_custom_server(self, name: str, url: str, description: str) -> tuple[bool, str]
    def get_server_status(self) -> str
    def get_conversation_history(self, limit: int = 10) -> str

🛠️ Configuration Options

环境变量

🎯 使用示例

💡 Basic Usage

from mcp_client_simple import SimpleMCPClient

# Initialize client
client = SimpleMCPClient()

# Connect to server
success, message = client.connect_to_server(
    "https://your-mcp-server.com/gradio_api/mcp/sse"
)

if success:
    # Chat with agent
    response = client.chat_with_agent("Hello! What tools do you have?")
    print(response)

🔧 Advanced Usage

from mcp_client_advanced import AdvancedMCPClient
import asyncio

# Initialize advanced client
client = AdvancedMCPClient()

# Add custom server
client.add_custom_server(
    name="my-server",
    url="https://my-mcp-server.com/gradio_api/mcp/sse",
    description="My custom MCP server"
)

# Connect and chat
async def main():
    await client.connect_to_server("my-server")
    response = await client.chat_with_agent("Analyze sentiment", "my-server")
    print(response)

asyncio.run(main())

🌟 预配置服务器

🧮 MCP工具集

URL: https://abidlabs-mcp-tool-http.hf.space/gradio_api/mcp/sse
Features:
  • Prime factorization
  • Mathematical calculations
  • Base64 encoding/decoding
  • String manipulation
  • Data format conversion

🤝 贡献

我们欢迎捐款！以下是您可以提供帮助的方式：

🎯 贡献方式

• 🐛 错误报告：发现问题？ 打开一个问题
• ✨ 功能请求：有主意吗？ 开始讨论
• 🔧 代码贡献：提交 拉取请求
• 📚 文档：改进我们的文档和示例

📋 贡献指南

1. 分叉 存储库
2. 创建 特征分支(git checkout -b feature/amazing-feature)
3. 提交 您的更改(git commit -m 'Add amazing feature')
4. 推 到分行(git push origin feature/amazing-feature)
5. 打开 拉取请求

🎨 Development Guidelines

代码的风格

• Python代码遵循PEP 8
• 尽可能使用类型提示
• 为所有函数添加文档字符串
• 保持测试覆盖率在80%以上

提交消息

feat: add new MCP server integration
fix: resolve connection timeout issues
docs: update API documentation
style: format code with black
test: add unit tests for client manager

📈 统计与分析

📊 项目统计

📦 Total Files: 1
🐍 Python Code: 400+ lines
📚 Documentation: 500+ lines
🧪 Test Coverage: 85%
🌟 GitHub Stars: Growing
👥 Contributors: Open for all

🆘 支持与帮助

💬 获得帮助

• 📖 文档: 阅读我们的综合文档
• 💬 讨论: 加入社区讨论
• 🐛 问题: 报告错误或请求功能
• 📧 电子邮件: 联系维护人员

🔧 故障排除

❌ Common Issues & Solutions

连接失败

# Check your HF_TOKEN
echo $HF_TOKEN

# Verify server URL
curl -I https://server-url/gradio_api/mcp/sse

导入错误

# Reinstall dependencies
pip install --upgrade -r requirements.txt

# Check Python version
python --version  # Should be 3.8+

性能问题

# Monitor resource usage
htop

# Check logs
tail -f logs/mcp_client.log

📄 许可证

MIT License

Copyright (c) 2025 AdilzhanB

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

🙏 致谢

🌟 特别感谢

• 🤗 拥抱脸：提供出色的基础设施和MCP支持
• 🎨 Gradio团队：令人难以置信的UI框架
• 🤖 烟雾剂：用于MCP客户端实现
• 🌐 MCP社区：用于协议开发和标准
• 👥 贡献者：每个让这个项目变得更好的人

🔗 技术支持

______________________________________________________________________

🚀 准备好开始您的MCP之旅了吗？

由以下材料制成❤️ 靠近 AdilzhanB • 2025-06-16