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