Horoscope

🚀 星座運勢 MCP 服務器

星座運勢 MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務，它集成了星座運勢 API，能為全部十二星座提供詳細的運勢解讀，支持多時間範圍查詢，滿足用戶對星座運勢的多樣化需求。

🚀 快速開始

本服務器提供了便捷的安裝和使用方式，讓你能迅速獲取星座運勢信息。

✨ 主要特性

• 全星座覆蓋：支持全部十二星座的運勢查詢。
• 多時間範圍：提供今日、明日、本週、本月等多個時間範圍的運勢查詢。
• 詳細運勢解讀：包含整體運勢、愛情運勢、事業運勢、財運運勢、健康運勢等方面。
• 特色信息：提供幸運數字、幸運顏色和速配星座。
• 宜忌指南：為用戶提供星座運勢的宜忌建議。
• 完善的錯誤處理：具備完善的錯誤處理和數據驗證機制。

📦 安裝指南

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

高級用法

在基礎用法上，你可以根據需求靈活組合 type 和 time 參數，以獲取不同星座在不同時間範圍的運勢信息。例如，你可以查詢金牛座本週的運勢：

use_mcp_tool with:
server_name: "horoscope"
tool_name: "get_horoscope"
arguments: {
  "type": "taurus",
  "time": "week"
}

參數說明

• type：星座類型，支持以下值：
  • "aries"（白羊座）
  • "taurus"（金牛座）
  • "gemini"（雙子座）
  • "cancer"（巨蟹座）
  • "leo"（獅子座）
  • "virgo"（處女座）
  • "libra"（天秤座）
  • "scorpio"（天蠍座）
  • "sagittarius"（射手座）
  • "capricorn"（摩羯座）
  • "aquarius"（水瓶座）
  • "pisces"（雙魚座）
• time：時間範圍，支持以下值：
  • "today"（今日）
  • "tomorrow"（明日）
  • "week"（本週）
  • "month"（本月）

返回數據示例

白羊座 2024年3月27日運勢

▎ 整體運勢 ★★★★☆
今天的運勢相當不錯，工作上會有意外的收穫...

▎ 愛情運勢 ★★★★
單身的你可能會遇到心儀的對象...

[更多運勢內容...]

🔧 技術細節

本服務器使用以下技術構建：

• TypeScript：提供類型安全的開發體驗。
• Model Context Protocol SDK：實現 MCP 協議的相關功能。
• Node.js Fetch API：用於與星座運勢 API 進行數據交互。
• Zod：用於參數驗證，確保輸入數據的有效性。

📚 詳細文檔

錯誤處理

服務器包含完善的錯誤處理機制，涵蓋以下情況：

• 無效的星座類型
• 無效的時間範圍
• API 請求失敗
• 數據解析錯誤

錯誤返回時會包含適當的錯誤代碼和描述性消息。

貢獻指南

歡迎提交貢獻！請隨時提交 Pull Request。

📄 許可證

本項目採用 MIT 許可證，您可以在自己的項目中自由使用。