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）がある。ほとんどのサーバーはnpmで公開されており、npxで起動できる。

AstroWay MCPサーバーは、主要なアストロロジー計算をカバーする25のツールを提供している：

• natal_chart — 完全な出生図
• synastry — 2人の相性診断
• transits — 現在のトランジット（通過）を出生図に反映
• daily_horoscope, weekly_horoscope, monthly_horoscope, yearly_horoscope
• interpret_natal, interpret_synastry, interpret_transits — AIによる解釈
• human_design — 完全なHuman Designマップ
• hd_incarnation_cross, hd_compatibility — Human Design固有の機能
• その他12のツールで、プログレッション、ソーラーリターン、アストロカルトログラフィー、レクティフィケーションなどをカバー

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は自動で以下を行う：

• 自然言語を解析（都市名→座標）
• 適切なツールを選択
• 回答をフォーマット

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. 「1987年4月22日16:45にロンドンで生まれた人のHuman Designタイプを計算して」
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クレジット程度で済む。無料枠で十分だ。

プロダクションのエージェントで数百人のユーザーがいる場合は、使用するエンドポイントの組み合わせに応じて計算しよう。1,000人のユーザー向けのデイリーホロスコープボットなら、1,000 × 20 × 30 = 600,000クレジット/月で、Proプランが必要になる。

• AstroWay MCP on npm
• AIエージェントとMCP — 使用例 — 完全な統合ガイド
• ホロスコープ&AI解釈API — プロダクトページ
• クイックスタート — APIキーを無料で取得（月10,000クレジット）