mcp-jvb

🚀 MCP服务器项目说明

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

🚀 快速开始

安装步骤

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)

✨ 主要特性

• 文件访问：支持上传、下载、列出和删除文件操作。
• 数据库连接：集成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文档：提供了所有接口的详细描述及其使用方法。
• 通义千问示例：展示了如何与通义千问集成并进行交互。

🔧 技术细节

项目结构

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文件。