Horoscope

🚀 星座運勢 MCP サーバー | Horoscope 運勢 MCP サーバー

星座の運勢や運程予測を提供する Model Context Protocol (MCP) サーバーです。このサーバーは星座運勢 API を統合しており、全 12 星座の詳細な運勢解釈を提供します。

🚀 クイックスタート

このサーバーは星座運勢 API を統合しており、全 12 星座の詳細な運勢解釈を提供します。

✨ 主な機能

• 全 12 星座の運勢照会に対応
• 複数の時間範囲（今日、明日、今週、今月）
• 詳細な運勢解釈は以下を含む：
  • 全体運勢
  • 恋愛運勢
  • 仕事運勢
  • 金運運勢
  • 健康運勢
• 幸運番号、幸運色、相性の良い星座
• 吉凶ガイド
• 完璧なエラー処理とデータ検証

📦 インストール

1. リポジトリをクローンします：

git clone https://github.com/GBcui/horoscope-serve.git
cd horoscope-serve

2. 依存関係をインストールします：

npm install

3. サーバーをビルドします：

npm run build

4. MCP 設定構成ファイルに追加します（具体的な場所はシステムによって異なります）：

VSCode Claude 拡張機能の場合：

{
  "mcpServers": {
    "horoscope": {
      "command": "node",
      "args": ["/path/to/horoscope-serve/build/index.js"]
    }
  }
}

💻 使用例

基本的な使用法

use_mcp_tool with:
server_name: "horoscope"
tool_name: "get_horoscope"
arguments: {
  "type": "aries",
  "time": "today"
}

高度な使用法

牡羊座 2024年3月27日運勢

▎ 全体運勢 ★★★★☆
今日の運勢はかなり良く、仕事で意外な収穫があります...

▎ 恋愛運勢 ★★★★
独身のあなたは気に入った相手に出会うかもしれません...

[その他の運勢内容...]

パラメータ説明

• type: 星座のタイプで、以下の値をサポートします：
  • "aries"（牡羊座）
  • "taurus"（牡牛座）
  • "gemini"（双子座）
  • "cancer"（蟹座）
  • "leo"（獅子座）
  • "virgo"（乙女座）
  • "libra"（天秤座）
  • "scorpio"（蠍座）
  • "sagittarius"（射手座）
  • "capricorn"（山羊座）
  • "aquarius"（水瓶座）
  • "pisces"（魚座）
• time: 時間範囲で、以下の値をサポートします：
  • "today"（今日）
  • "tomorrow"（明日）
  • "week"（今週）
  • "month"（今月）

🔧 技術詳細

以下の技術を使用して構築されています：

• TypeScript
• Model Context Protocol SDK
• Node.js Fetch API
• Zod を使用したパラメータ検証

エラー処理

サーバーには完璧なエラー処理メカニズムが含まれており、以下をカバーします：

• 無効な星座タイプ
• 無効な時間範囲
• API リクエストの失敗
• データ解析エラー

エラーが返される際には、適切なエラーコードと説明メッセージが含まれます。

🤝 貢献ガイド

貢献を歓迎します！いつでも Pull Request を送信してください。

📄 ライセンス

MIT ライセンス - あなたのプロジェクトで自由に使用できます。