Thêm chiêm tinh vào đại lý AI của bạn thông qua MCP

Nếu bạn đã làm việc với Claude Desktop trong năm qua - có lẽ bạn đã thấy MCP (Model Context Protocol). Đây là một tiêu chuẩn mở của Anthropic để kết nối các công cụ bên ngoài với các mô hình AI. Chỉ với vài dòng cấu hình - Claude đã có thể truy cập hệ thống tệp, cơ sở dữ liệu hoặc bất kỳ API nào.

Trong bài viết này - cách thêm tính toán chiêm tinh vào tác nhân AI thông qua MCP. Thời gian - ít hơn 5 phút.

MCP là giao thức mà các mô hình AI sử dụng để gọi các công cụ. Hãy tưởng tượng nó như “REST API cho các tác nhân AI”:

• Máy chủ (Server) cung cấp các công cụ (tính toán, truy vấn, hành động)
• Khách hàng (Client) (Claude Desktop, Cursor, tác nhân tùy chỉnh) phát hiện và gọi các công cụ này
• Mô hình tự quyết định khi nào nên sử dụng công cụ cụ thể: dựa trên yêu cầu của người dùng

Các máy chủ MCP có thể là cục bộ (chạy như một tiến trình con) hoặc từ xa (HTTP). Hầu hết các máy chủ cục bộ được đăng ký trên npm và chạy thông qua npx.

Máy chủ MCP AstroWay cung cấp một công cụ cho mỗi thao tác API, 735 công cụ trong gói npm và 843 trên máy chủ được host, với tên dạng astroway_<nhóm>_<thao tác>:

• astroway_western_chart và các công cụ liền kề cho biểu đồ, chuyển tiếp, tiến trình và vòng quay
• astroway_relational_* cho hợp tử, hợp thành và biểu đồ nhóm
• astroway_ai_interpret_natal, astroway_ai_interpret_synastry: Diễn giải AI
• Các nhóm về Thiết kế Con người, chiêm tinh Ấn Độ, Trung Quốc, Hy Lạp, Tarot và Numerology

Để rút gọn danh sách, hãy kết nối một máy chủ miền duy nhất thay vì toàn bộ danh mục, xem cấu hình MCP

Đăng ký trên astroway.info và tạo khóa API miễn phí (10.000 tín dụng/tháng, không cần thẻ).

Tệp claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Thêm máy chủ astroway:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["@astroway/mcp"],
      "env": {
        "ASTROWAY_API_KEY": "aw_live_your_key_here"
      }
    }
  }
}

Sau khi khởi động lại, các công cụ AstroWay sẽ xuất hiện trong menu công cụ trong ô nhập liệu trò chuyện.

Bây giờ, hãy trò chuyện với Claude bằng ngôn ngữ tự nhiên:

Bạn: Xây dựng biểu đồ sinh cho người sinh ngày 14 tháng 7 năm 1990 lúc 14:30 tại Kyiv. Mặt Trời ở Cự Giải ở nhà thứ 10 có ý nghĩa gì?

Claude: Gọi natal_chart với tọa độ đã phân tích, sau đó interpret_placement. Đây là biểu đồ sinh. Mặt Trời ở Cự Giải ở nhà thứ 10 chỉ ra…

Claude tự động:

• phân tích ngôn ngữ tự nhiên (thành phố → tọa độ)
• chọn công cụ phù hợp
• định dạng câu trả lời

Nếu bạn đang xây dựng một tác nhân AI tùy chỉnh (không phải Claude Desktop), bạn vẫn có thể sử dụng máy chủ MCP. Giao thức đã được tài liệu hóa:

import { spawn } from 'child_process';

const mcp = spawn('npx', ['@astroway/mcp'], {
  env: {
    ...process.env,
    ASTROWAY_API_KEY: process.env.ASTROWAY_API_KEY,
  },
  stdio: ['pipe', 'pipe', 'pipe'],
});

// MCP initialize
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 1,
  method: 'initialize',
  params: { protocolVersion: '2024-11-05', capabilities: {} },
}) + '\n');

// List the tools
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 2,
  method: 'tools/list',
}) + '\n');

// Call a tool
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 3,
  method: 'tools/call',
  params: {
    name: 'natal_chart',
    arguments: {
      date: '1990-07-14',
      time: '14:30:00',
      timezoneOffset: 3,
      latitude: 50.4501,
      longitude: 30.5234,
    },
  },
}) + '\n');

Hầu hết các framework tác nhân (LangChain, LlamaIndex, v.v.) có hỗ trợ tích hợp sẵn cho MCP.

Nếu bạn không muốn tốn kém thêm cho MCP, hãy gọi API HTTP trực tiếp từ tác nhân:

async function callAstrowayTool(tool: string, input: object) {
  const res = await fetch(`https://api.astroway.info/v1/${tool}`, {
    method: 'POST',
    headers: {
      'X-Api-Key': process.env.ASTROWAY_API_KEY!,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify(input),
  });
  return res.json();
}

// Use in your agent loop
const chart = await callAstrowayTool('chart', birthData);

Ưu điểm của MCP: mô tả công cụ có cấu trúc, tự động phát hiện, xử lý lỗi tiêu chuẩn hóa. Ưu điểm của HTTP: đơn giản hơn, hoạt động ở mọi nơi, không cần tiến trình con.

Khi MCP được cấu hình, hãy thử trong Claude:

1. “Tử vi hàng ngày của tôi là gì? Tôi sinh ngày 3 tháng 10 năm 1993 lúc 6 giờ sáng tại New York”.
2. “Tính loại Thiết kế Con người của tôi. Sinh ngày 22 tháng 4 năm 1987 lúc 16:45 tại London”.
3. “So sánh sự tương thích giữa hai người: tôi (14 tháng 7 năm 1990, Kyiv) và bạn gái (22 tháng 3 năm 1992, Paris)”.
4. “Những chuyển tiếp chính nào dành cho tôi hôm nay? Hãy đưa ra diễn giải”.
5. “Tôi không biết chính xác giờ sinh. Phân tích độ nhạy cho phạm vi ±30 phút cho thấy điều gì?”

Claude sẽ tự chọn các công cụ cần thiết, gọi chúng theo chuỗi và định dạng câu trả lời bằng ngôn ngữ tự nhiên.

Các công cụ diễn giải AI của AstroWay (interpret_*, *_horoscope) có các biện pháp an toàn tích hợp:

• Không có lời khuyên y tế, pháp lý hoặc tài chính
• Tự động chèn disclaimer
• Lọc nội dung

Khi tác nhân hiển thị văn bản diễn giải cho người dùng, hãy giữ lại disclaimer. Nó nằm trong trường disclaimer của mỗi câu trả lời AI.

Các lệnh gọi MCP đi qua cùng hệ thống tín dụng như HTTP. Các truy vấn đơn giản (10 tín dụng) → biểu đồ (20) → hợp tử (50) → diễn giải AI (50).

Đối với sử dụng cá nhân (một người dùng đặt câu hỏi cho Claude) - khoảng 200-500 tín dụng mỗi tháng. Gói miễn phí là đủ.

Đối với tác nhân sản xuất cho hàng trăm người dùng - hãy tính toán tùy thuộc vào hỗn hợp các endpoint. Bot tử vi hàng ngày cho 1.000 người dùng = 1.000 × 20 × 30 = 600.000 tín dụng/tháng → gói Pro.

• AstroWay MCP trên npm
• Tác nhân AI và MCP: use case: hướng dẫn tích hợp đầy đủ
• API Tử vi & Diễn giải AI: trang sản phẩm
• Bắt đầu nhanh: nhận khóa API (miễn phí, 10.000 tín dụng/tháng)