MCP服务器项目说明

项目概述

MCP（多功能计算平台）服务器是一款功能强大的后端服务，支持文件访问、数据库连接、API集成和向量数据库访问等多种功能。本项目专为与通义千问(Qwen)等大型语言模型集成而设计，提供了完整的Docker部署配置和通义千问调用示例。

项目结构

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        # 依赖列表

功能特性

• 文件访问：支持上传、下载、列出和删除文件操作
• 数据库连接：集成MongoDB，支持文档的增删改查功能
• API集成：支持调用外部API服务
• 向量数据库：支持向量存储和相似度搜索
• Docker部署：提供完整的Docker配置，实现一键部署
• 通义千问集成：提供通义千问调用MCP服务器的客户端库和示例代码

快速开始

安装步骤

1. 克隆项目代码：

git clone https://github.com/ningwenjie/mcp_server
cd mcp_server

2. 使用Docker Compose启动服务：

docker-compose -f docker/docker-compose.yml up -d

3. 验证服务运行状态：

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文档：提供了所有接口的详细描述及其使用方法。
• 通义千问示例：展示了如何与通义千问集成并进行交互。

测试信息

• 服务器测试脚本：验证服务器核心功能是否正常运行。
• 通义千问客户端测试脚本：测试与通义千问的交互接口是否稳定可靠。

项目依赖

• Python：3.8及以上版本
• Docker：2.0及以上版本
• MongoDB：4.0及以上版本
• 相关库：numpy, pandas, requests等

许可证信息

本项目遵循MIT License协议，具体许可证内容请参考LICENSE文件。