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许可证。