MCPでAIエージェントにアストロロジーを追加

もしこの1年でClaude Desktopを使っていたなら、きっと MCP（Model Context Protocol）を見たことがあるはずだ。これはAnthropicが公開している、外部ツールをAIモデルに接続するための標準だ。設定を数行書くだけで、Claudeはファイルシステムやデータベース、任意のAPIにアクセスできるようになる。

この投稿では、MCPを通してAIエージェントに占星計算を組み込む方法を紹介する。所要時間は5分未満だ。

MCPは、AIモデルがツールを呼び出すためのプロトコルだ。AIエージェント向けの「REST API」のようなものと考えてくれ。

• サーバー がツール（計算、クエリ、アクション）を提供する
• クライアント（Claude Desktop、Cursor、カスタムエージェント）がそれらを検出して呼び出す
• モデル自身がユーザーのリクエストに基づいて、どのツールをいつ使うかを決める

MCPサーバーはローカル（サブプロセスとして起動）とリモート（HTTP）の2種類がある。ほとんどはローカルで、npmで公開され、npxで起動する。

MCPサーバー AstroWay は、主要な占星計算をカバーする25個のツールを提供する：

• natal_chart: 完全な出生図
• synastry: 2人の相性
• 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. 「2人の相性を比較して：僕（1990年7月14日、キエフ）と友人（1992年3月22日、パリ）」
4. 「今日の主要なトランジットは何？ 解釈を教えて」
5. 「出生時刻が分からない。±30分の範囲で感度分析はどうなる？」

Claude自身が必要なツールを選び、連続して呼び出し、人間らしい言葉で結果を整形してくれる。

AstroWayのAI解釈ツール（interpret_*、*_horoscope）には組み込みの安全ガードレールがある：

• 医療、法務、金融に関する助言は一切提供しない
• 自動挿入の免責文
• コンテンツフィルタリング

エージェントがユーザーに解釈テキストを表示するときは、免責文を保持しよう。免責文は各AI応答の disclaimer フィールドに入っている。

MCP呼び出しはHTTPと同じクレジットシステムを通す。シンプルなクエリ (10クレジット) → チャート (20) → シナストリー (50) → AI解釈 (50)。

個人利用（Claudeに質問する1ユーザー）では、月間約200〜500クレジット程度。無料プランで余裕がある。

数百ユーザー向けの本番エージェントの場合は、エンドポイントの組み合わせで計算する。Daily-horoscopeボットで1,000ユーザーの場合 = 1,000 × 20 × 30 = 600,000クレジット/月 → Proプラン。

• AstroWay MCP（npm）
• AIエージェントとMCP: ユースケース: 完全な統合ガイド
• Horoscope & AI Interpretations API: 製品ページ
• クイックスタート: APIキーを取得（無料、月間10,000クレジット）