# Fortune MCP Server

ホロスコープとタロット占いを提供するMCP（Model Context Protocol）サーバーです。

## 機能

- **タロット占い**: 指定した枚数のタロットカードを引いて占い結果を返します
- **ホロスコープ**: 指定した日時（または現在時刻）のホロスコープを計算して返します

## インストール
**uvx**

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

**local install**

```shell
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 Code

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

#### JSON
Claude Desktopなどの設定ファイル（`claude_desktop_config.json`）に以下を追加:

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

### MCP ツール

#### 1. draw_tarot
タロットカードを引いて占い結果を返します。

パラメータ:
- `count` (integer, optional): 引くカードの枚数（1-10、デフォルト: 3）

#### 2. get_horoscope
ホロスコープを計算して返します。

パラメータ:
- `datetime` (string, optional): 計算する日時（YYYY-MM-DD HH:MM:SS形式、省略時は現在時刻）
- `random` (boolean, optional): ランダムな日時でホロスコープを生成するか（デフォルト: false）
- `latitude` (number, optional): 緯度（デフォルト: 東京 35.6895）
- `longitude` (number, optional): 経度（デフォルト: 東京 139.6917）

## 依存関係

- mcp[cli]: MCP プロトコルの実装
- pyswisseph: ホロスコープ計算用ライブラリ
- pytz: タイムゾーン処理

## ライセンス

MIT