MCP Jvb

🚀 MCP Server Project Introduction

The MCP (Multi-functional Computing Platform) server is a powerful backend service that supports various functions such as file access, database connection, API integration, and vector database access. This project is specifically designed for integration with large language models like Tongyi Qianwen (Qwen), providing a complete Docker deployment configuration and examples of calling Qwen.

🚀 Quick Start

Installation Steps

1. Clone the project code:

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

2. Start the service using Docker Compose:

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

3. Verify the service running status:

curl http://localhost:8000/health

Usage Examples of Qwen Client

from examples.qwen_client import QwenMCPClient

# Initialize the client instance
client = QwenMCPClient("http://localhost:8000")

# File upload operation
file_info = client.upload_file("example.txt")

# Vector storage function
vector = [0.1, 0.2, 0.3]  # Example vector value
client.store_vector(file_path="example.txt", vector=vector)

# Retrieve similar files
similar_files = client.search_vectors(vector=[0.1, 0.2], top_k=3)

✨ Features

• File Access: Supports file upload, download, listing, and deletion operations.
• Database Connection: Integrates MongoDB and supports create, read, update, and delete operations on documents.
• API Integration: Supports calling external API services.
• Vector Database: Supports vector storage and similarity search.
• Docker Deployment: Provides a complete Docker configuration for one-click deployment.
• Qwen Integration: Provides a client library and example code for Qwen to call the MCP server.

📦 Installation

The installation steps are described in the "Quick Start" section above.

💻 Usage Examples

Basic Usage

from examples.qwen_client import QwenMCPClient

# Initialize the client instance
client = QwenMCPClient("http://localhost:8000")

# File upload operation
file_info = client.upload_file("example.txt")

# Vector storage function
vector = [0.1, 0.2, 0.3]  # Example vector value
client.store_vector(file_path="example.txt", vector=vector)

# Retrieve similar files
similar_files = client.search_vectors(vector=[0.1, 0.2], top_k=3)

Advanced Usage

# Advanced scenarios can involve more complex operations, such as batch file uploads and multi - dimensional vector searches.
# For example, batch file upload:
from examples.qwen_client import QwenMCPClient
client = QwenMCPClient("http://localhost:8000")
file_list = ["file1.txt", "file2.txt", "file3.txt"]
for file in file_list:
    client.upload_file(file)

# Multi - dimensional vector search
vector = [0.1, 0.2, 0.3, 0.4, 0.5]
similar_files = client.search_vectors(vector=vector, top_k=5)

📚 Documentation

• User Guide: Details how to install, configure, and use the MCP server.
• API Documentation: Provides detailed descriptions and usage methods for all interfaces.
• Qwen Examples: Demonstrates how to integrate and interact with Qwen.

🔧 Technical Details

The project structure is as follows:

mcp_server/
├── src/                    # Source code directory
│   ├── __init__.py         # Initialization module
│   ├── config.py           # Configuration management
│   ├── server.py           # Server main class
│   └── modules/            # Functional modules
│       ├── __init__.py     # Module registration
│       ├── file_module.py  # File access module
│       ├── database_module.py # Database connection module
│       ├── api_module.py   # API integration module
│       └── vector_module.py # Vector database module
├── docker/                 # Docker configuration
│   ├── Dockerfile          # Docker image configuration
│   └── docker-compose.yml  # Docker Compose configuration
├── examples/               # Example code
│   ├── qwen_client.py      # Qwen client library
│   └── qwen_example.py     # Qwen usage example
├── docs/                   # Documentation
│   ├── user_guide.md       # User guide
│   ├── api_docs.md         # API documentation
│   └── qwen_examples.md    # Qwen example description
├── test_server.py          # Server test script
├── test_qwen_client.py     # Qwen client test script
├── main.py                 # Main entry file
└── requirements.txt        # Dependency list

📄 License

This project follows the MIT License. Please refer to the LICENSE file for the specific license content.

Additional Information

Testing

• Server Test Script: Verifies whether the core functions of the server are running normally.
• Qwen Client Test Script: Tests the stability and reliability of the interaction interface with Qwen.

Dependencies

• Python: Version 3.8 or higher
• Docker: Version 2.0 or higher
• MongoDB: Version 4.0 or higher
• Related Libraries: numpy, pandas, requests, etc.