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

Якщо 지난 1년 동안 Claude Desktop을 사용했다면 MCP(Model Context Protocol)를 본 적이 있을 거야. 이것은 Anthropic이 만든 외부 도구를 AI 모델에 연결하기 위한 오픈 표준이야. 몇 줄의 설정만 하면 Claude가 파일 시스템, DB, 혹은 어떤 API에도 접근할 수 있어.

이 포스트에서는 MCP를 통해 AI 에이전트에 천문학 계산을 추가하는 방법을 알려줄게. 시간은 5분 이하야.

MCP는 AI 모델이 도구를 호출하는 프로토콜이야. 마치 «AI 에이전트를 위한 REST API»처럼 생각하면 돼:

• 서버는 도구(계산, 요청, 행동)를 제공해
• 클라이언트(Claude Desktop, Cursor, 커스텀 에이전트)가 이를 발견하고 호출해
• 모델이 스스로 언제 어떤 도구를 사용할지 결정해: 사용자의 요청을 기반으로

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

AstroWay MCP 서버 25개의 도구를 제공해, 주요 천문학 계산을 모두 커버해:

• natal_chart: 전체 출생 차트
• synastry: 두 사람의 궁합
• transits: 출생 차트에 대한 현재 트랜짓
• 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, 천문 지도, 보정 등을 커버해

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일 14:30에 키예프에서 태어난 사람의 출생 차트를 만들어줘. 그녀의 태양이 게자리 10번째 하우스에 있으면 무슨 의미야?

Claude: natal_chart를 파싱된 좌표와 함께 호출하고, 그 다음 interpret_placement를 호출해. 여기 출생 차트야. 게자리 10번째 하우스에 있는 태양은 …

Claude가 직접:

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

커스텀 AI 에이전트를 만들고 있다면 (Claude Desktop이 아니라), 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 initialize
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 타입을 계산해줘. 나는 1987년 4월 22일 16시 45분에 런던에서 태어났어.”
3. “두 사람의 궁합을 비교해줘: 나 (1990년 7월 14일, 키예프)와 친구 (1992년 3월 22일, 파리).”
4. “오늘 나에게 주요 트랜짓은 뭐야? 해석도 알려줘.”
5. “출생 정확한 시간을 몰라. ±30분 범위에 대한 sensitivity 분석 결과가 뭐야?”

Claude가 스스로 필요한 도구를 선택하고, 체인처럼 여러 개를 호출한 뒤 인간 같은 언어로 답변을 포맷해.

AstroWay의 AI 해석 도구(interpret_*, *_horoscope)는 내장된 safety-guardrails를 가지고 있어:

• 의료, 법률, 재무 조언 금지
• 자동 삽입된 면책조항
• 콘텐츠 필터링

에이전트가 사용자에게 해석 텍스트를 보여줄 때는 면책조항을 유지해. 면책조항은 각 AI 응답의 disclaimer 필드에 있어.

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

개인 사용(Claude에게 질문하는 한 명)이라면 월 200~500 크레딧 정도야. 무료 플랜도 충분히 커버돼.

수백 명의 사용자를 위한 프로덕션 에이전트라면 엔드포인트 조합에 따라 계산해. Daily-horoscope 봇 1 000명 사용자 = 1 000 × 20 × 30 = 600 000 크레딧/월 → Pro 플랜.

• npm의 AstroWay MCP
• AI 에이전트와 MCP: use case: 전체 통합 가이드
• Horoscope & AI Interpretations API: 제품 페이지
• 빠른 시작: API 키 받기 (무료, 10 000 크레딧/월)