Fortune MCP

🚀 運勢MCP服務器

這是一個提供星座運勢和塔羅牌占卜服務的MCP（模型上下文協議）服務器，能為用戶提供精準的占卜結果。

🚀 快速開始

運勢MCP服務器可提供塔羅牌占卜和星座運勢計算服務，為用戶帶來獨特的占卜體驗。

✨ 主要特性

• 塔羅牌占卜：抽取指定數量的塔羅牌，並返回占卜結果。
• 星座運勢：計算指定日期（或當前時間）的星座運勢並返回。

📦 安裝指南

使用uvx安裝

uvx --from git+https://github.com/takada-at/fortune_mcp fortune-mcp-server

本地安裝

git clone https://github.com/takada-at/fortune_mcp.git
cd fortune_mcp
uv sync
uv run --directory /abs/path/to/fortune_mcp fortune-mcp-server

💻 使用示例

MCP配置

Claude代碼配置

claude mcp add fortune -- uvx --from git+https://github.com/takada-at/fortune_mcp fortune-mcp-server

JSON配置

在Claude Desktop等配置文件（claude_desktop_config.json）中添加以下內容：

{
  "mcpServers": {
    "fortune": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/takada-at/fortune_mcp", "fortune-mcp-server"]
    }
  }
}

MCP工具使用

1. draw_tarot

抽取塔羅牌並返回占卜結果。

參數：

• count（整數，可選）：抽取的牌數（1 - 10，默認值：3）

2. get_horoscope

計算並返回星座運勢。

參數：

• datetime（字符串，可選）：計算的日期和時間（格式：YYYY - MM - DD HH:MM:SS，省略時為當前時間）
• random（布爾值，可選）：是否以隨機日期生成星座運勢（默認值：false）
• latitude（數字，可選）：緯度（默認值：東京 35.6895）
• longitude（數字，可選）：經度（默認值：東京 139.6917）

🔧 技術細節

依賴關係

• mcp[cli]：MCP協議的實現。
• pyswisseph：用於星座運勢計算的庫。
• pytz：時區處理。

📄 許可證

本項目採用MIT許可證。