使用说明
MCP Server
MCP Server là một máy chủ triển khai giao thức Model Context Protocol (MCP), cho phép các mô hình ngôn ngữ lớn (LLMs) tương tác với các công cụ và dịch vụ bên ngoài một cách chuẩn hóa.
Tính năng
- Hỗ trợ nhiều công cụ khác nhau (calculator, weather, search)
- API RESTful với FastAPI
- Xác thực dữ liệu với Pydantic
- Xử lý bất đồng bộ hiệu quả
- Tài liệu API tự động với Swagger UI
Yêu cầu hệ thống
- Python 3.8+
- pip (Python package manager)
Cài đặt
- Clone repository:
git clone <repository-url>
cd mcp-server
- Tạo và kích hoạt môi trường ảo:
python -m venv venv
# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate
- Cài đặt các thư viện cần thiết:
pip install -r requirements.txt
Chạy server
python main.py
Server sẽ chạy tại địa chỉ: http://localhost:8000
API Endpoints
1. Root Endpoint
- URL:
/ - Method: GET
- Description: Trả về thông tin về server và danh sách các công cụ được hỗ trợ
2. Execute Tool
- URL:
/execute - Method: POST
- Description: Thực thi một công cụ với các tham số được cung cấp
- Request Body:
{
"tool_name": "calculator",
"parameters": {
"operation": "add",
"numbers": [1, 2, 3]
},
"context": {}
}
Các công cụ được hỗ trợ
1. Calculator
- Thực hiện các phép tính cơ bản
- Tham số:
operation: "add" hoặc "multiply"numbers: mảng các số cần tính
2. Weather
- Lấy thông tin thời tiết cho một địa điểm
- Tham số:
location: tên địa điểm
3. Search
- Thực hiện tìm kiếm web
- Tham số:
query: từ khóa tìm kiếm
Tài liệu API
Truy cập http://localhost:8000/docs để xem tài liệu API đầy đủ với Swagger UI.
Phát triển
Thêm công cụ mới
- Thêm tên và mô tả công cụ vào
SUPPORTED_TOOLS - Thêm hàm xử lý mới trong
process_tool_request - Tạo hàm xử lý riêng cho công cụ mới
Chạy tests
pytest
License
MIT License
