# mcp_test

**Repository Path**: qingtinggit/mcp_test

## Basic Information

- **Project Name**: mcp_test
- **Description**: 期望用于快速对接各种mcp
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-04
- **Last Updated**: 2025-10-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MCP协议对接项目

本项目提供了一套完整的MCP（Model Context Protocol）协议对接解决方案，支持多种通信方式，帮助开发者快速实现与MCP服务的集成。

## 项目结构

```
.
├── mcp_client/       # MCP客户端核心库
│   ├── __init__.py
│   ├── base_client.py
│   ├── http_client.py
│   ├── stdio_client.py
│   ├── sse_client.py
│   └── client_factory.py
├── examples/         # 使用示例
│   ├── general_example.py
│   ├── http_client_example.py
│   ├── stdio_client_example.py
│   └── sse_client_example.py
├── docs/             # 文档
│   └── mcp_protocol_guide.md
├── requirements.txt  # 依赖列表
└── .env              # 环境变量配置
```

## 功能特性

- **多通信方式支持**：HTTP、Stdio、SSE
- **统一的API接口**：提供一致的使用体验
- **灵活的配置**：支持环境变量和代码配置
- **完善的错误处理**：提供详细的日志和错误信息
- **上下文管理器支持**：自动处理连接的创建和关闭

## 快速开始

### 1. 安装依赖

```bash
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
```

### 2. 配置环境变量

编辑`.env`文件，配置MCP服务器地址和相关参数：

```
MCP_SERVER_URL=http://localhost:8000/mcp
MCP_API_KEY=your_api_key_here
MCP_COMMUNICATION_MODE=http
```

### 3. 使用示例

#### 基本用法

```python
from mcp_client import create_mcp_client

# 使用上下文管理器
with create_mcp_client() as client:
    # 获取工具列表
    tools = client.list_tools()
    print(f"可用工具: {[tool['name'] for tool in tools]}")
    
    # 调用工具
    # result = client.call_tool('tool_name', {'param1': 'value1'})
```

#### 特定通信方式

```python
# HTTP客户端
http_client = create_mcp_client(communication_mode='http')

# Stdio客户端
stdio_client = create_mcp_client(communication_mode='stdio')

# SSE客户端
sse_client = create_mcp_client(communication_mode='sse')
```

### 4. 运行示例程序

```bash
# 通用示例
python examples/general_example.py

# HTTP客户端示例
python examples/http_client_example.py

# Stdio客户端示例
python examples/stdio_client_example.py

# SSE客户端示例
python examples/sse_client_example.py
```

## 详细文档

请参考`docs/mcp_protocol_guide.md`获取完整的MCP协议对接指南，包括：

- MCP协议的基本概念
- 连接流程详解
- 核心功能说明
- 不同通信方式的选择
- 常见问题与解决方案
- 最佳实践

## 开发注意事项

1. **调试模式**：设置`debug=True`可以获取详细的通信日志
2. **错误处理**：使用try-except捕获可能的异常
3. **资源管理**：优先使用上下文管理器管理连接
4. **参数验证**：调用工具前验证参数格式

## 支持的MCP功能

- ✅ 初始化连接
- ✅ 工具列表查询
- ✅ 工具调用
- ✅ 会话管理
- ✅ 多种通信方式支持

## 许可证

Apache License 2.0