README.md•1.97 kB
# 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