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 - chắc chắn bạn đã thấy MCP (Model Context Protocol). Đây là 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ỉ cần một vài dòng cấu hình - và Claude có thể truy cập vào hệ thống tệp, cơ sở dữ liệu hoặc bất kỳ API nào.

Trong bài đăng này - chúng tôi sẽ hướng dẫn bạn cách thêm tính toán chiêm tinh vào AI agent thông qua MCP. Thời gian - ít hơn 5 phút.

MCP - giao thức mà các mô hình AI 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ủ cung cấp các công cụ (tính toán, yêu cầu, hành động)
• Khách hàng (Claude Desktop, Cursor, tác nhân tùy chỉnh) phát hiện và gọi chúng
• Mô hình tự quyết định khi nào áp dụng công cụ nào - dựa trên yêu cầu của người dùng

Máy chủ MCP có thể là cục bộ (khởi chạy như một quá trình con) và từ xa (HTTP). Hầu hết các máy chủ cục bộ - được xuất bản trên npm và khởi chạy thông qua npx.

Máy chủ MCP AstroWay cung cấp 25 công cụ, bao gồm các tính toán chiêm tinh cơ bản:

• natal_chart - biểu đồ sinh hoàn chỉnh
• synastry - sự tương thích của hai người
• transits - các chuyển động hiện tại trên biểu đồ sinh
• daily_horoscope, weekly_horoscope, monthly_horoscope, yearly_horoscope
• interpret_natal, interpret_synastry, interpret_transits - diễn giải AI
• human_design - biểu đồ thiết kế con người hoàn chỉnh
• hd_incarnation_cross, hd_compatibility - tính năng thiết kế con người
• và 12 công cụ khác, bao gồm tiến trình, solar returns, chiêm tinh học, chỉnh sửa

Đăng ký trên astroway.info và tạo một API key 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, bạn sẽ thấy biểu tượng búa với 25 công cụ có sẵn.

Bây giờ, chỉ cần nói 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 Kiev. Ý nghĩa của Mặt trời trong Cự giải ở nhà 10 là gì?

Claude: Gọi natal_chart với các tọa độ được phân tích, sau đó interpret_placement. Đây là biểu đồ sinh. Mặt trời trong Cự giải ở nhà 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), máy chủ MCP cũng có thể được sử dụng. 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');

// Danh sách công cụ
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 2,
  method: 'tools/list',
}) + '\n');

// Gọi công cụ
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 cho tác nhân (LangChain, LlamaIndex, v.v.) có hỗ trợ tích hợp MCP.

Nếu bạn không muốn chi phí 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();
}

// Sử dụng trong vòng lặp tác nhân
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 được 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 quá trình con.

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

1. «Góc nhìn 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 toán loại thiết kế con người của tôi. 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 của hai người: tôi (14 tháng 7 năm 1990, Kiev) và bạn gái (22 tháng 3 năm 1992, Paris)».
4. «Những chuyển động chính cho tôi hôm nay là gì? Hãy cho tôi diễn giải».
5. «Tôi không biết thời gian sinh chính xác. Những gì cho thấy phân tích độ nhạy cho phạm vi ±30 phút?»

Claude tự động chọn công cụ phù hợp, gọi một chuỗi công cụ 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 rào cản bảo mật tích hợp:

• Không có lời khuyên y tế, pháp lý hoặc tài chính
• Disclaimer tự động được tiêm
• Bộ 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 - giữ disclaimer. Nó nằm trong trường disclaimer của mỗi câu trả lời AI.

Các cuộc gọi MCP đi qua cùng hệ thống tín dụng như HTTP. Các mẫu đơn giản (10 tín dụng) → biểu đồ (20) → synastry (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í đủ.

Đối với tác nhân sản xuất trên hàng trăm người dùng - tính toán dựa trên sự kết hợp của các điểm cuối. Bot góc nhìn 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 đủ
• Góc nhìn và diễn giải API - trang sản phẩm
• Bắt đầu nhanh - nhận API key (miễn phí, 10.000 tín dụng/tháng)