# Digital Zen Garden (數位枯山水) MCP Server

這是一個基於 `FastMCP` 構建的微服務，旨在為 AI 代理提供一個「數位修禪」的空間。
它可以生成 ASCII 枯山水庭園、整理沙紋、放置頑石，並提供數位冥想功能。

## 設計理念
在快節奏的數位世界中，AI 也需要片刻的寧靜。本專案透過純文字 (ASCII) 的形式，重現枯山水 (Karesansui) 的極簡美學。

## 功能 (Tools & Resources)

### Tools
*   `rake_garden(pattern)`: 整理庭園沙紋 (樣式: `~`, `-`, `=`, `≈`)。
*   `place_stone(x, y, stone_type)`: 在指定座標放置石頭。
*   `view_garden()`: 查看當前庭園景色。
*   `meditate(duration_seconds)`: 進行一段時間的專注冥想（即時回報進度）。

### Resources
*   `zen://koan/random`: 獲取隨機禪宗公案。
*   `zen://garden/ascii`: 獲取庭園當前狀態。

### Prompts
*   `meditation-guide`: 根據當前庭園景色，生成冥想引導詞。

## 快速開始

### 前置需求
*   Python 3.11+
*   `uv` 或 `pip`

### 安裝與執行

1.  **安裝依賴**
    ```bash
    make install
    ```

2.  **執行測試**
    ```bash
    make test
    ```

3.  **啟動伺服器**
    ```bash
    make run
    # 或是
    python src/server.py
    ```

### Claude Desktop 設定範例

請將以下設定加入您的 `claude_desktop_config.json`：

```json
{
  "mcpServers": {
    "zen-garden": {
      "command": "/absolute/path/to/python", 
      "args": ["/absolute/path/to/projects/mcp-daily-2026-01-30/src/server.py"]
    }
  }
}
```
**注意**：請務必將 `/absolute/path/to/...` 替換為您電腦上的實際絕對路徑。

## Docker 部署

```bash
make up
```

## Future Improvements
1.  **持久化儲存**：將庭園狀態儲存至 SQLite，讓景色得以保留。
2.  **多人共修**：允許多個 Client 連線至同一座庭園，共同維護。
3.  **天氣系統**：在 ASCII 渲染中加入「落葉」或「雨滴」的動態效果 (透過 Stream 更新)。

---
Generated by FastMCP Daily Generator on 2026-01-30.