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）の2種類があります。ほとんどのローカルサーバーはnpmで公開され、npxで実行されます。

AstroWay MCPサーバーは、各API操作ごとに1つのツールを提供し、npmパッケージには735個、ホスト型サーバーには843個のツールがあります。名前はastroway_<グループ>_<操作>の形式です：

• astroway_western_chartと、チャート、トランジット、プログレッション、リターンに関する隣接ツール
• astroway_relational_*は、シナストリー、コンポジット、グループチャート用
• astroway_ai_interpret_natal、astroway_ai_interpret_synastry：AI解釈
• Human Design、ヴェーダ占星術、中国占星術、ヘレニスティック占星術、タロット、数秘学のグループ

リストを短くするには、完全なカタログの代わりに1つのドメインサーバーを接続してください。MCPの設定を参照してください。

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"
      }
    }
  }
}

再起動後、AstroWayのツールがチャット入力フィールドのツールメニューに表示されます。

これで、Claudeと自然言語で対話できます：

あなた: 1990年7月14日14:30にキーウで生まれた人のnatal chartを作成してください。彼女の蟹座の10ハウスにある太陽は何を意味しますか？

Claude: natal_chartをパースされた座標で呼び出し、次にinterpret_placementを呼び出します。 こちらがnatal chartです。蟹座の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');

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

// Call a tool
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();
}

// Use in your agent loop
const chart = await callAstrowayTool('chart', birthData);

MCPの利点：構造化されたツールの説明、自動検出、標準化されたエラーハンドリング。HTTPの利点：よりシンプル、どこでも動作、サブプロセス不要。

MCPが設定されたら、Claudeで試してみてください：

1. “私の今日の星座は何ですか？私は1993年10月3日6時にニューヨークで生まれました”
2. “私のHuman Design typeを計算してください。1987年4月22日16:45にロンドンで生まれました”
3. “2人の人の相性を比較してください：私（1990年7月14日、キーウ）と友人（1992年3月22日、パリ）”
4. “今日の私の主要なトランジットは何ですか？解釈をください”
5. “正確な出生時間がわかりません。±30分の範囲でsensitivity分析は何を示しますか？”

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クレジット/月 → プロプラン。

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