🚀 MCP服务器项目说明
MCP（多功能计算平台）服务器是一款强大的后端服务，具备文件访问、数据库连接、API集成和向量数据库访问等丰富功能。该项目专为与通义千问（Qwen）等大型语言模型集成而打造，提供了完整的Docker部署配置以及通义千问调用示例。
🚀 快速开始
安装步骤
- 克隆项目代码：
git clone https://github.com/ningwenjie/mcp_server
cd mcp_server
- 使用Docker Compose启动服务：
docker-compose -f docker/docker-compose.yml up -d
- 验证服务运行状态：
curl http://localhost:8000/health
通义千问客户端使用示例
from examples.qwen_client import QwenMCPClient
# 初始化客户端实例
client = QwenMCPClient("http://localhost:8000")
# 文件上传操作
file_info = client.upload_file("example.txt")
# 向量存储功能
vector = [0.1, 0.2, 0.3] # 示例向量值
client.store_vector(file_path="example.txt", vector=vector)
# 检索相似文件
similar_files = client.search_vectors(vector=[0.1, 0.2], top_k=3)
✨ 主要特性
- 文件访问：支持上传、下载、列出和删除文件操作。
- 数据库连接：集成MongoDB，支持文档的增删改查功能。
- API集成：支持调用外部API服务。
- 向量数据库：支持向量存储和相似度搜索。
- Docker部署：提供完整的Docker配置，实现一键部署。
- 通义千问集成：提供通义千问调用MCP服务器的客户端库和示例代码。
📦 安装指南
- 克隆项目代码：
git clone https://github.com/ningwenjie/mcp_server
cd mcp_server
- 使用Docker Compose启动服务：
docker-compose -f docker/docker-compose.yml up -d
- 验证服务运行状态：
curl http://localhost:8000/health
💻 使用示例
基础用法
from examples.qwen_client import QwenMCPClient
# 初始化客户端实例
client = QwenMCPClient("http://localhost:8000")
# 文件上传操作
file_info = client.upload_file("example.txt")
# 向量存储功能
vector = [0.1, 0.2, 0.3] # 示例向量值
client.store_vector(file_path="example.txt", vector=vector)
# 检索相似文件
similar_files = client.search_vectors(vector=[0.1, 0.2], top_k=3)
📚 详细文档
- 用户指南：详细说明了如何安装、配置和使用MCP服务器。
- API文档：提供了所有接口的详细描述及其使用方法。
- 通义千问示例：展示了如何与通义千问集成并进行交互。
🔧 技术细节
项目结构
mcp_server/
├── src/ # 源代码目录
│ ├── __init__.py # 初始化模块
│ ├── config.py # 配置管理
│ ├── server.py # 服务器主类
│ └── modules/ # 功能模块
│ ├── __init__.py # 模块注册
│ ├── file_module.py # 文件访问模块
│ ├── database_module.py # 数据库连接模块
│ ├── api_module.py # API集成模块
│ └── vector_module.py # 向量数据库模块
├── docker/ # Docker配置
│ ├── Dockerfile # Docker镜像配置
│ └── docker-compose.yml # Docker Compose配置
├── examples/ # 示例代码
│ ├── qwen_client.py # 通义千问客户端库
│ └── qwen_example.py # 通义千问使用示例
├── docs/ # 文档
│ ├── user_guide.md # 用户指南
│ ├── api_docs.md # API文档
│ └── qwen_examples.md # 通义千问示例说明
├── test_server.py # 服务器测试脚本
├── test_qwen_client.py # 通义千问客户端测试脚本
├── main.py # 主入口文件
└── requirements.txt # 依赖列表
测试信息
- 服务器测试脚本：验证服务器核心功能是否正常运行。
- 通义千问客户端测试脚本：测试与通义千问的交互接口是否稳定可靠。
项目依赖
- Python：3.8及以上版本
- Docker：2.0及以上版本
- MongoDB：4.0及以上版本
- 相关库：numpy, pandas, requests等
📄 许可证
本项目遵循MIT License协议，具体许可证内容请参考LICENSE文件。