MCP를 통해 AI 에이전트에 아스트로로지 추가하기

최근 1년 동안 Claude Desktop을 사용해왔다면 MCP(Model Context Protocol)를 접해봤을 거야.これはAI 모델이 외부 도구를 연결할 수 있도록 Anthropic에서 만든 개방형 표준이야. 몇 줄의 설정만으로 Claude가 파일 시스템, 데이터베이스 또는 모든 API에 접근할 수 있게 돼.

이 글에서는 MCP를 통해 AI 에이전트에 점성술 계산을 추가하는 방법을 5분 안에 설명할 거야.

MCP는 AI 모델이 도구를 호출할 수 있도록 하는 프로토콜이야. 마치 “AI 에이전트를 위한 REST API”라고 생각하면 돼:

• 서버는 도구(계산, 쿼리, 작업)를 제공해
• 클라이언트(Claude Desktop, Cursor, 커스텀 에이전트)는 이를 감지하고 호출해
• 모델은 사용자 요청을 기반으로 어떤 도구를 언제 사용할지 스스로 결정해

MCP 서버는 로컬(하위 프로세스로 실행) 또는 원격(HTTP)으로 나뉘어. 대부분은 npm에 게시되어 npx로 실행돼.

AstroWay MCP 서버는 기본 점성술 계산을 다루는 25개의 도구를 제공해:

• natal_chart — 전체 natal 차트
• synastry — 두 사람의 호환성
• transits — natal 차트에 대한 현재 transit
• daily_horoscope, weekly_horoscope, monthly_horoscope, yearly_horoscope
• interpret_natal, interpret_synastry, interpret_transits — AI 해석
• human_design — 전체 HD 차트
• hd_incarnation_cross, hd_compatibility — HD 기능 -还有12개의 도구로, 진행, solar returns, astrocartography, rectification 등을 다뤄

astroway.info에 가입하고 무료 API 키를 발급받아(월 10,000 크레딧, 카드 불필요).

claude_desktop_config.json 파일:

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

astroway 서버를 추가해:

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

재시작하면 망치 아이콘과 함께 25개의 사용 가능한 도구가 표시될 거야.

이제 Claude와 자연어로 대화할 수 있어:

너: 1990년 7월 14일 오후 2시 30분에 키예프에서 태어난 사람의 natal 차트를 그려줘. 그의 천조궁 10번째 Houses에 있는 태양이 무엇을 의미하지?

Claude: natal_chart를 파싱된 좌표로 호출한 다음 interpret_placement를 호출할 거야. Вот natal 차트. 태양이 게자리 10번째 Houses에 있으면 다음과 같은 의미를 지녀…

Claude가 스스로:

• 자연어를 파싱(도시 → 좌표)
• 올바른 도구를 선택
• 응답을 포맷팅

Claude Desktop이 아니라 커스텀 AI 에이전트를 구축한다면 MCP 서버를 사용할 수도 있어. 프로토콜은 문서화되어 있어:

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 초기화
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 1,
  method: 'initialize',
  params: { protocolVersion: '2024-11-05', capabilities: {} },
}) + '\n');

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

// 도구 호출
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');

LangChain, LlamaIndex 등 대부분의 에이전트 프레임워크는 MCP를 기본 지원해.

MCP 오버헤드가 부담된다면 에이전트에서 직접 HTTP-API를 호출할 수도 있어:

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();
}

// 에이전트 루프에서 사용
const chart = await callAstrowayTool('chart', birthData);

MCP의 장점: 구조화된 도구 설명, 자동 감지, 표준화된 오류 처리. HTTP의 장점: 더 간단하고 어디서나 동작하며 하위 프로세스가 필요 없어.

MCP가 설정되면 Claude에서 시도해 봐:

1. “내 오늘의 운세는 어때? 1993년 10월 3일 오전 6시에 뉴욕에서 태어났어.”
2. “내 Human Design type을 계산해줘. 1987년 4월 22일 오후 4시 45분에 런던에서 태어났어.”
3. “두 사람의 호환성을 비교해줘: 나(1990년 7월 14일, 키예프)와 여자친구(1992년 3월 22일, 파리).”
4. “오늘 나에게 주요 transit가 뭐야? 해석도 해줘.”
5. “출생 시간을 정확히 몰라. ±30분 범위의 sensitivity 분석을 보여줘.”

Claude가 필요한 도구를 스스로 선택하고 체인 호출을 수행한 다음 자연어로 응답을 포맷팅할 거야.

AstroWay의 AI 해석 도구(interpret_*, *_horoscope)에는 안전 가드레일이 내장되어 있어:

• 의료, 법률, 재정 조언 금지
• 자동 삽입된 disclaimer
• 콘텐츠 필터링

에이전트가 사용자에게 해석 텍스트를 표시할 때 disclaimer를 유지해. 각 AI 응답의 disclaimer 필드에 포함되어 있어.

MCP 호출은 HTTP와 동일한 크레딧 시스템을 사용해. 간단한 조회(10크레딧) → 차트(20) → synastry(50) → AI 해석(50).

개인 사용자(Claude에 질문하는 한 명의 사용자)의 경우 월 약 200~500크레딧 소요. 무료 요금제로도 충분해.

프로덕션 에이전트(수백 명의 사용자)의 경우 사용되는 엔드포인트 조합에 따라 계산해. 1,000명의 사용자를 위한 daily horoscope 봇 = 1,000 × 20 × 30 = 월 600,000크레딧 → Pro 플랜.

• npm의 AstroWay MCP
• AI 에이전트와 MCP — 사용 사례 — 전체 통합 가이드
• Horoscope & AI Interpretations API — 제품 페이지
• 빠른 시작 — API 키 무료 발급(월 10,000크레딧)