7mLabs Omni-MCP (I-Ching)

Kết nối trực tiếp bộ xử lý I-Ching Engine với các AI Assistants (Claude Desktop, Cursor, Windsurf, Antigravity...) thông qua giao thức mở Model Context Protocol.

1. Kết nối Remote với Cursor (SSE Transport)

Mã nguồn Omni-MCP mà chúng ta đang chạy sử dụng giao thức SSE (Server-Sent Events). Điều này có nghĩa là bạn HOÀN TOÀN CÓ THỂ ĐEM NÓ LÊN VPS chạy như một API Server bình thường (VD: https://mcp.mystic.community/sse).

Để kết nối AI Editor (như Cursor) tới Server này, bạn vào cài đặt Cursor: Cursor Settings > Features > MCP > Add New MCP Server và điền:

Name: 7mlabs-iching
Type: SSE
URL: https://mcp.mystic.community/sse?key=<API_KEY_CỦA_BẠN>
Lưu ý: API Key phải được cấp bởi Admin 7mLabs. Thay thế <API_KEY_CỦA_BẠN> bằng key thực tế.

Cách thức xin cấp API Key:

Sẽ cập nhật trong thời gian sớm nhất. Hệ thống phân quyền hiện tại hỗ trợ giới hạn tool access dựa trên Tier của API Key.

Mẫu khai báo cấu hình file (Dành cho Cursor)

Nếu bạn cấu hình tự động thông qua file .cursor/mcp.json trong dự án Cursor của bạn, đây là mẫu chuẩn:

{
  "mcpServers": {
    "7mlabs-omni": {
      "type": "sse",
      "url": "https://mcp.mystic.community/sse?key=<NHẬP_API_KEY_BẠN_ĐƯỢC_CẤP_VÀO_ĐÂY>"
    }
  }
}

2. Các Tools hiện có trên I-Ching Engine

Hệ thống I-Ching MCP cung cấp các API để thao tác gieo quẻ và phân tích Đồ Trận (Quẻ Chủ, Quẻ Biến, Hào Động, Thể Dụng):

iching_cast_random: Gieo quẻ Kinh Dịch ngẫu nhiên (mô phỏng phương pháp gieo 3 đồng xu 6 lần). Trả về JSON Graph phân tích Đồ Trận để AI làm ngữ cảnh tư vấn.
iching_analyze_hexagram: Phân tích quẻ thủ công dựa trên mảng 6 số (6, 7, 8, 9) đại diện cho 6 hào từ Sơ đến Thượng (6=Lão Âm, 7=Thiếu Dương, 8=Thiếu Âm, 9=Lão Dương).