Trình tác tử AI và MCP

Bạn đang xây dựng một tác nhân AI cần thực hiện các phép tính chiêm tinh thực tế thay vì ảo giác? AstroWay kết nối với Claude (Anthropic), ChatGPT-4 (OpenAI), Llama 3.3 (Groq), DeepSeek, Google Gemini, Mistral - thông qua MCP, llms.txt hoặc các lệnh gọi HTTP trực tiếp. Ba cách tích hợp - hãy chọn theo loại tác nhân của bạn:

• llms.txt: các tệp khám phá cho các tác nhân đọc tài liệu (Cursor IDE, Windsurf, Claude trong trình duyệt, các pipeline RAG tùy chỉnh trên LangChain/LlamaIndex).
• Máy chủ MCP: không cần code cho Claude Desktop, Cursor IDE, Windsurf, VS Code (llm CLI) và bất kỳ máy khách tương thích MCP nào (bao gồm GPT với MCP thông qua OpenAI Realtime API).
• HTTP API: truy cập trực tiếp từ tác nhân hoặc framework của riêng bạn (LangChain, LlamaIndex, AutoGen, CrewAI).

llms.txt: khám phá cho các tác nhân AI

Trang web hiển thị hai tệp có thể đọc được bằng máy ở định dạng llms.txt:

• /llms.txt: chỉ mục của tất cả các trang tài liệu được nhóm theo các phần (API Reference, Use Cases, Examples, Products). Nhỏ gọn, vừa với bất kỳ cửa sổ ngữ cảnh nào.
• /llms-full.txt: toàn bộ nội dung tài liệu trong một tệp văn bản thuần túy. Thích hợp để lập chỉ mục ngoại tuyến vào cơ sở dữ liệu vector hoặc đưa vào ngữ cảnh một lần.

Khi nào nên sử dụng

Kịch bản	Tệp
Cursor/Windsurf “đọc tài liệu AstroWay và giúp tích hợp”	/llms.txt (tác nhân sẽ tự động lấy các phần cần thiết)
Pipeline RAG của riêng bạn / Cơ sở dữ liệu vector cho bot FAQ	/llms-full.txt (một lần lấy - toàn bộ nội dung)
Claude/ChatGPT trong trình duyệt: “đây là API của chúng tôi, hãy xây dựng một máy khách”	/llms-full.txt dán vào lời nhắc
Tác nhân sản xuất với việc thực hiện các lệnh gọi	Máy chủ MCP hoặc HTTP API (xem bên dưới)

Ví dụ: kéo vào tác nhân của riêng bạn

const docs = await fetch('https://api.astroway.info/llms-full.txt').then(r => r.text());

const systemPrompt = `You are an integration assistant for AstroWay API.
Documentation:
${docs}

When the user asks how to do X, return a working code snippet using their API key.`;

Ghi chú

Các tệp được tạo lại tự động sau mỗi lần phát hành trang web. Độ mới được đảm bảo: phiên bản API ở cuối /llms.txt khớp với triển khai sản xuất hiện tại.

Máy chủ MCP (được khuyến nghị cho Claude Desktop)

Model Context Protocol (MCP) - một tiêu chuẩn mở để kết nối các công cụ với các mô hình AI. Máy chủ MCP của AstroWay cung cấp 783 công cụ, mỗi công cụ cho một thao tác API, cũng như 12 lời nhắc và 14 tài nguyên.

Cấu hình cho Claude Desktop

Thêm vào claude_desktop_config.json:

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

Sau khi khởi động lại, Claude Desktop sẽ thấy tất cả 783 công cụ. Để rút ngắn danh sách, hãy đặt ASTROWAY_TOOL_GROUPS hoặc kết nối máy chủ miền, xem cấu hình MCP.

Máy chủ MCP có thể làm gì

Công cụ	Chức năng
astroway_western_chart	Tính toán biểu đồ sinh
astroway_relational_synastry	Đối chiếu hai người
astroway_horoscope_daily	Tử vi hàng ngày
astroway_ai_interpret_natal	Giải thích biểu đồ sinh bằng AI
astroway_hd_human_design	Biểu đồ HD đầy đủ
astroway_prognostics_transits	Các quá cảnh hiện tại

Danh sách đầy đủ: 783 công cụ, toàn bộ API, mỗi công cụ có một schema phản hồi được định kiểu.

Ví dụ về hội thoại với Claude

Người dùng: Hãy xây dựng biểu đồ sinh cho một 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 trong nhà 10 có ý nghĩa gì?

Claude: Sử dụng astroway_western_chart để tính toán, sau đó astroway_ai_interpret_placement để giải thích. Trả về vị trí các hành tinh với dữ liệu thực và một giải thích có ý nghĩa.

HTTP API

Đối với các tác nhân AI không hỗ trợ MCP - hãy sử dụng HTTP API trực tiếp.

Để tạo nội dung

TypeScript

// The AI agent calls /interpret/natal for an interpretation
const r = await fetch('https://api.astroway.info/v1/interpret/natal', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
  }),
});

const { data: result } = await r.json();
// result.interpretation - ready AI interpretation
// result.disclaimer - disclaimer to display

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/interpret/natal',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
    json={
        'date': '1990-07-14',
        'time': '14:30:00',
        'timezoneOffset': 3,
        'latitude': 50.4501,
        'longitude': 30.5234,
    },
)
result = r.json()['data']
# result['interpretation'] - ready AI interpretation
# result['disclaimer']     - disclaimer to display

cURL

curl -X POST https://api.astroway.info/v1/interpret/natal \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

PHP

<?php
use GuzzleHttp\Client;

$aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $aw->post('interpret/natal', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'date' => '1990-07-14',
        'time' => '14:30:00',
        'timezoneOffset' => 3,
        'latitude' => 50.4501,
        'longitude' => 30.5234,
    ],
]);

$result = json_decode($r->getBody(), true)['data'];
// $result['interpretation'] - ready AI interpretation
// $result['disclaimer']     - disclaimer to display

Để tính toán + LLM của riêng bạn

// 1. Get raw data from /chart (cheaper - 20 credits)
const chart = await fetch('https://api.astroway.info/v1/chart', { ... });
const { data } = await chart.json();

// 2. Pass the data to your own LLM
const prompt = `Interpret this natal chart: ${JSON.stringify(data.planets)}`;
const llmResponse = await myLLM.generate(prompt);

Mẹo

Nếu bạn chỉ cần giải thích - hãy sử dụng /interpret/* (50 tín dụng, văn bản đã sẵn sàng). Nếu bạn muốn kiểm soát lời nhắc - hãy lấy /chart (20 tín dụng) và truyền dữ liệu vào LLM của bạn.

Các kịch bản

Trợ lý chiêm tinh cá nhân

Máy chủ MCP + Claude/ChatGPT. Người dùng hỏi - tác nhân tính toán và giải thích. Ngân sách: Gói Free cho mục đích sử dụng cá nhân.

Bot nội dung cho mạng xã hội

Tạo tử vi hàng ngày cho 12 cung hoàng đạo thông qua /horoscope/daily. 12 yêu cầu mỗi ngày = 240 tín dụng. Gói Free với nhiều dư dả.

Nền tảng huấn luyện AI

/interpret/natal + /interpret/transits cho mỗi khách hàng. 100 khách hàng/ngày = 10.000 tín dụng/ngày. Gói Pro.

Bắt đầu nhanh → Yêu cầu đầu tiên trong 5 phút

Horoscope API Giải thích AI và tử vi

Giá cả Từ miễn phí đến Enterprise