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. 安裝依賴

   make install
   

2. 執行測試

   make test
   

3. 啟動伺服器

   make run
   # 或是
   python src/server.py
   

Claude Desktop 設定範例

請將以下設定加入您的 claude_desktop_config.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 部署

make up

Future Improvements

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

---

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