tuvi-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tuvi-mcp Phân tích ngày sinh 1998-07-19"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
TuVi MCP - Máy Bói Toán Việt Nam
Một MCP (Model Context Protocol) server cung cấp các công cụ bói toán dựa trên lịch âm Việt Nam, sử dụng các yếu tố như Can Chi, Ngũ Hành, Xung Khắc, và các phương pháp bói toán truyền thống.
Tính năng
1. Chi Tiết Ngày Sinh (get_date_of_birth_detail)
Phân tích chi tiết ngày sinh bao gồm:
Ngày âm lịch
Tuổi Can Chi (Can + Chi)
Ngũ Hành mệnh
Nạp Âm
Quái số
Phật Đồ Mạng
Cung Phi (hướng tốt)
2. Dự Đoán Vận Hạn Hàng Ngày (get_daily_fortune)
Dự đoán vận hạn dựa trên tương quan giữa ngày sinh và ngày cần xem:
Quan hệ tổng thể
Quan hệ Can
Quan hệ Chi
Quan hệ Ngũ Hành
3. Dự Đoán Vận Hạn Chung (get_general_fortune)
Thông tin vận hạn chung cho mọi người trong ngày:
Ngày âm lịch và tiết khí
Can Chi ngày
Hướng Tài Thần, Hỷ Thần, Quý Nhân
Trực ngày
Phận Can, Phận Chi
Nhi thập bát tú
Thập nhị kiến trừ
Lục diệu
Related MCP server: Lunar Calendar MCP Server
Cài đặt
Yêu cầu hệ thống
Python 3.12+
PDM (Python Dependency Manager)
Các bước cài đặt
Clone repository:
git clone <repository-url> cd tuvi-mcpCài đặt dependencies:
pdm installCài đặt package:
pdm build pip install dist/tuvi_mcp-0.1.0.tar.gz
Sử dụng
Chạy MCP Server
Sau khi cài đặt, bạn có thể chạy MCP server bằng:
tuvi-mcpSử dụng trong ứng dụng MCP
Server này tuân theo Model Context Protocol và có thể được tích hợp vào các ứng dụng hỗ trợ MCP như Claude Desktop, VS Code, etc.
Cấu hình FastMCP Server
Chạy trực tiếp
Sau khi cài đặt package, bạn có thể chạy server trực tiếp:
tuvi-mcpCấu hình với Claude Desktop
Thêm vào file cấu hình Claude Desktop (claude_desktop_config.json):
Trên macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Trên Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"tuvi-mcp": {
"command": "tuvi-mcp"
}
}
}Cấu hình với VS Code (Cursor)
Thêm vào file settings VS Code/Cursor:
{
"mcp": {
"servers": {
"tuvi-mcp": {
"command": "tuvi-mcp"
}
}
}
}Chạy trong Development Mode
Khi phát triển, bạn có thể chạy server trực tiếp từ source:
Cách 1: Chạy trực tiếp với Python
# Từ thư mục gốc của project
python -m src.mainCách 2: Sử dụng PDM script (khuyến nghị)
# Cài đặt dependencies nếu chưa có
pdm install
# Chạy server với script đã định nghĩa
pdm run devCách 3: Cài đặt package ở chế độ editable
# Cài đặt package ở chế độ development
pdm install
# Sau đó có thể chạy như đã cài đặt
tuvi-mcpKiểm tra server hoạt động
Test với MCP Inspector (khuyến nghị):
# Cài đặt MCP Inspector
pip install mcp-inspector
# Chạy inspector và kết nối với server
mcp-inspector python -m src.mainHoặc test với MCP CLI:
# Cài đặt mcp CLI (nếu chưa có)
pip install mcp
# Test server (cần cài đặt package trước)
pip install -e .
mcp dev tuvi-mcpVí dụ sử dụng
from src.main import mcp
# Lấy chi tiết ngày sinh
result = mcp.call_tool("get_date_of_birth_detail", {
"date_of_birth": "1998-07-19",
"gender": 1,
"format": "text"
})
# Dự đoán vận hạn hàng ngày
result = mcp.call_tool("get_daily_fortune", {
"date_of_birth": "1998-07-19",
"forecast_day": "2024-12-24",
"format": "text"
})
# Dự đoán vận hạn chung
result = mcp.call_tool("get_general_fortune", {
"forecast_day": "2024-12-24",
"format": "json"
})API Reference
get_date_of_birth_detail
Parameters:
date_of_birth(string): Ngày sinh theo định dạng YYYY-MM-DDgender(int, optional): Giới tính (1: nam, 0: nữ), mặc định là 1format(string, optional): Định dạng trả về ("text" hoặc "json"), mặc định là "text"
Returns: Chi tiết ngày sinh dưới dạng text hoặc JSON
get_daily_fortune
Parameters:
date_of_birth(string): Ngày sinh theo định dạng YYYY-MM-DDforecast_day(string, optional): Ngày cần dự đoán, mặc định là hôm nayformat(string, optional): Định dạng trả về ("text" hoặc "json"), mặc định là "text"
Returns: Dự đoán vận hạn hàng ngày
get_general_fortune
Parameters:
forecast_day(string, optional): Ngày cần dự đoán, mặc định là hôm nayformat(string, optional): Định dạng trả về ("text" hoặc "json"), mặc định là "text"
Returns: Dự đoán vận hạn chung
Dependencies
fastmcp (>=2.14.1): Framework cho MCP server
lunardate (>=0.2.2): Xử lý ngày âm lịch
lunar-python (>=1.4.8): Thư viện lịch âm Trung Quốc/Việt Nam
Kiến trúc dự án
src/
├── main.py # Entry point và định nghĩa MCP tools
├── libs/
│ ├── can_chi.py # Các hàm liên quan đến Can Chi, Ngũ Hành
│ ├── lunar_date.py # Xử lý ngày âm lịch
│ ├── xung_khac.py # Tính toán xung khắc
│ └── khuyen.py # Các bảng khuyên, phán đoán
└── tools/ # Các công cụ bổ sungPhát triển
Chạy tests
python -m pytest tests/Chạy development server
python src/main.pyĐóng góp
Mời đóng góp bằng cách tạo Issue hoặc Pull Request trên GitHub.
Giấy phép
MIT License - Xem file LICENSE để biết thêm chi tiết.
Lưu ý
Thông tin được cung cấp chỉ mang tính tham khảo và giải trí. Không nên sử dụng để đưa ra quyết định quan trọng trong cuộc sống.
Available Tools
3 toolsget_daily_fortuneB
Get a daily fortune based on the date of birth and the forecast day
Inputs: date_of_birth (required), format, forecast_day. Returns: result
get_date_of_birth_detailC
Get the detail of the date of birth
Inputs: date_of_birth (required), format, gender. Returns: result
get_general_fortuneA
Get a general fortune for everyone based on the forecast day
Inputs: format, forecast_day. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool serves a clear, non-overlapping purpose: one returns details about a birth date, one provides a personalized daily fortune, and one gives a general daily fortune. There is no ambiguity in what each tool does.
All tool names follow the 'get_' prefix followed by a descriptive noun: get_date_of_birth_detail, get_daily_fortune, get_general_fortune. The pattern is uniform and predictable.
With exactly 3 tools, the set is lean but covers the core functions of a fortune-telling service without unnecessary bloat. Each tool earns its place and the count is within the ideal 3-15 range.
The domain (fortune-telling based on birth date) is fully addressed: detail extraction, personalized fortune, and general fortune. There are no obvious dead ends or missing operations for the stated purpose.
Maintenance
Related MCP Connectors
MCP server for China public holidays and lunar calendar: solar-lunar conversion and yearly schedule.
Hosted remote MCP server for BaZi (Four Pillars) charts and the Chinese almanac. No install.
Korean saju fortune MCP: natal chart, today/daily/yearly luck, compatibility, and saved profiles.
Vietnamese Tử Vi charts, lunar calendar, good-day finder and age compatibility. Free, no sign-in.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for accurate Bazi calculations, enabling personality analysis, destiny forecasting, and Chinese calendar queries via AI agents.ISC
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server for Chinese traditional calendar functions, including BaZi calculation, calendar conversion, Huangli query, daily fortune, solar terms, and Wu Xing analysis.5MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that calculates saju (four pillars) from birth date/time and provides entertaining interpretations of daily fortune, yearly luck, compatibility, name analysis, and tarot using MIT-licensed manseryeok-js.-
- AlicenseNot gradedqualityDmaintenanceMCP server that generates fortune context packs based on Saju, Zi Wei Dou Shu, and Western astrology for AI interpretation, enabling reflective entertainment and structured self-counseling in KakaoTalk conversations.AGPL 3.0