Máy chủ MCP: Sử dụng AstroAPI từ các trợ lý AI

AstroAPI cung cấp một máy chủ Model Context Protocol (MCP) được lưu trữ sẵn. Kết nối nó với một trợ lý AI như Claude Code, Claude Desktop hoặc Cursor, và trợ lý có thể gọi AstroAPI trực tiếp — tra cứu nơi sinh, tính toán bản đồ sao và giải thích kết quả bằng ngôn ngữ dễ hiểu.

Đây cũng là cách nhanh nhất để xây dựng một tích hợp: kết nối máy chủ MCP với trợ lý lập trình AI của bạn và yêu cầu nó viết mã tích hợp cho bạn. Trợ lý có thể thực hiện các lệnh gọi API thật trong khi làm việc, nên nó thấy được phản hồi thực tế thay vì phải đoán.

Không cần viết mã

Sau khi kết nối, bạn chỉ cần hỏi trợ lý những câu như "Tính bản đồ sao khai sinh cho một người sinh ngày 15 tháng 6 năm 1990 lúc 14:30 tại Amsterdam" — trợ lý sẽ xác định vị trí, gọi API và tóm tắt kết quả.

Endpoint

https://mcp.astroapi.cloud/mcp

Giao thức truyền tải: Streamable HTTP
Xác thực: khóa AstroAPI thông thường của bạn, được gửi trong header X-Api-Key
Các module, giới hạn tốc độ và hạn mức của gói đăng ký của bạn được áp dụng chính xác như khi gọi API trực tiếp.

Bạn có thể tạo khóa API trong bảng điều khiển tại mục API Keys. Xem Xác thực để biết chi tiết.

Kết nối Claude Code

Chạy lệnh này một lần trong terminal của bạn:

bash

claude mcp add --transport http astroapi https://mcp.astroapi.cloud/mcp \
  --header "X-Api-Key: YOUR_API_KEY"

Sau đó chỉ cần yêu cầu Claude Code sử dụng AstroAPI — ví dụ: "Dùng các công cụ astroapi để tính bản đồ sao khai sinh cho 1990-06-15 14:30 tại Amsterdam và tạo cho tôi một React component hiển thị nó."

Kết nối Cursor

Thêm đoạn sau vào .cursor/mcp.json trong dự án của bạn (hoặc ~/.cursor/mcp.json để áp dụng toàn cục):

json

{
  "mcpServers": {
    "astroapi": {
      "url": "https://mcp.astroapi.cloud/mcp",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Kết nối các MCP client khác

Bất kỳ client nào hỗ trợ MCP qua Streamable HTTP với header tùy chỉnh đều hoạt động. Cấu hình:

Cài đặt	Giá trị
URL	`https://mcp.astroapi.cloud/mcp`
Giao thức truyền tải	Streamable HTTP
Header	`X-Api-Key: YOUR_API_KEY`

Client được lưu trữ không hỗ trợ header tùy chỉnh

Một số client được lưu trữ (chẳng hạn các web connector của claude.ai) không thể gửi header tùy chỉnh và yêu cầu OAuth. Hỗ trợ OAuth đang nằm trong lộ trình phát triển; hiện tại, hãy dùng một client hỗ trợ header tùy chỉnh, như Claude Code, Claude Desktop hoặc Cursor.

Các công cụ có sẵn

Công cụ	Chức năng
`astro_resolve_place`	Tra cứu tên địa điểm và trả về tọa độ cùng múi giờ IANA. Các trợ lý được hướng dẫn gọi công cụ này trước tiên, để không bao giờ phải đoán tọa độ.
`astro_natal_chart`	Tính bản đồ sao khai sinh (các điểm, các cung nhà, các góc chiếu), tùy chọn kèm văn bản luận giải, và trả về một bản tóm tắt gọn gàng, dễ đọc.
`astro_synastry`	So sánh hai bản đồ sao khai sinh và liệt kê các góc chiếu giữa hai bản đồ theo cả hai chiều.
`astro_composite`	Tính bản đồ sao tổng hợp (điểm giữa) cho mối quan hệ, với các vị trí và góc chiếu riêng.
`astro_transits`	Tìm các quá cảnh trên một bản đồ sao khai sinh trong một khoảng thời gian (tối đa 2 năm): ngày bắt đầu, ngày chính xác và ngày kết thúc cho từng góc chiếu.
`astro_compatibility`	Điểm tương hợp nhanh giữa hai người dựa trên cung Mặt Trời.
`astro_solar_return`	Bản đồ sao hồi quy Mặt Trời cho một năm nhất định (bản đồ sao sinh nhật chiêm tinh).
`astro_lunar_return`	Bản đồ sao hồi quy Mặt Trăng từ một ngày nhất định (khoảng mỗi tháng một lần).
`astro_progressions`	Tiến trình thứ cấp cho một ngày mục tiêu, bao gồm các góc chiếu với bản đồ sao khai sinh.
`astro_human_design`	Một bodygraph Human Design đầy đủ: Loại, Chiến lược, Thẩm quyền, Hồ sơ, các trung tâm, các kênh và các cổng.
`astro_moon_sun`	Pha Mặt Trăng cùng giờ mọc/lặn, chính ngọ và giờ chạng vạng cho một ngày và địa điểm.
`astro_moon_calendar`	Báo cáo theo ngày (cung, pha, Mặt Trăng vô định — void-of-course) hoặc tổng quan một khoảng thời gian về các pha, các lần đổi cung và các giai đoạn vô định.
`astro_retrograde_calendar`	Các giai đoạn nghịch hành với ngày dừng (station), các cung đi qua và các giai đoạn bóng (shadow).
`astro_chinese_horoscope`	Con giáp và ngũ hành theo tử vi Trung Hoa, hoặc dự báo theo năm.
`astro_numerology`	Hồ sơ thần số học đầy đủ từ ngày sinh và họ tên, hoặc chỉ con số Đường Đời.
`astro_numerology_compatibility`	Độ tương hợp giữa hai người dựa trên con số Đường Đời của họ.
`astro_horoscope`	Các báo cáo tử vi soạn sẵn theo ngày, theo tuần, theo năm và theo năm cho cung Mọc.
`astro_ai_summary`	Viết một bản tóm tắt ngắn về ý nghĩa của lá số, dựa trên các vị trí và góc chiếu mạnh nhất. Cần mô-đun AI Summary.

Nhiều công cụ khác (bản đồ chiêm tinh địa lý, hình ảnh bản đồ sao và hơn thế nữa) đang được phát triển. Tính khả dụng của công cụ phụ thuộc vào các module trong gói đăng ký của bạn: một công cụ không nằm trong gói của bạn sẽ trả về một thông báo rõ ràng thay vì dữ liệu.

Phiên làm việc mẫu

Một cuộc trò chuyện với trợ lý đã kết nối có thể diễn ra như sau:

Bạn: Cung Mặt Trời và cung Mọc của một người sinh ngày 3 tháng 3 năm 1985 lúc 6:45 tại Barcelona là gì?
Trợ lý: gọi astro_resolve_place với "Barcelona", sau đó gọi astro_natal_chart với tọa độ và múi giờ đã xác định — Mặt Trời ở cung Song Ngư tại 12°41′ trong nhà thứ 1, và cung Mọc là Bảo Bình 28°10′ …

Trợ lý đảm nhận việc mã hóa địa lý, chuyển đổi múi giờ và gọi API — những việc thường dễ sai sót khi nhập dữ liệu ngày sinh thủ công.

Bước tiếp theo

Xác thực — tạo và quản lý khóa API
Bắt đầu — những kiến thức API cơ bản đằng sau các công cụ này
Bản đồ sao khai sinh — kết quả trả về của phép tính bản đồ sao khai sinh

Máy chủ MCP: Sử dụng AstroAPI từ các trợ lý AI ​

Endpoint ​

Kết nối Claude Code ​

Kết nối Cursor ​

Kết nối các MCP client khác ​

Các công cụ có sẵn ​

Phiên làm việc mẫu ​

Bước tiếp theo ​