DAISYS MCP Server

Daisys MCP 伺服器

Daisys-mcp 目前為測試版本，尚未有穩定發行版。但您可以透過以下步驟試用：

1. 在 Daisys 上註冊帳號，並建立使用者名稱與密碼。

若您在 macOS 上執行，請執行以下指令：

brew install portaudio

若您在 Linux 上執行，請執行以下指令：

sudo apt install portaudio19-dev libjack-dev

2. 在您的 MCP 客戶端（Claude Desktop、Cursor、mcp-cli、mcp-vscode 等）的 MCP 設定檔中，加入以下設定：

{
  "mcpServers": {
    "daisys-mcp": {
      "command": "uvx",
      "args": ["daisys-mcp"],
      "env": {
        "DAISYS_EMAIL": "{Your Daisys Email}",
        "DAISYS_PASSWORD": "{Your Daisys Password}",
        "DAISYS_BASE_STORAGE_PATH": "{Path where you want to store your audio files}"
      }
    }
  }
}

從原始碼建置：

1. 複製儲存庫：git clone https://github.com/daisys-ai/daisys-mcp.git

2. 進入儲存庫目錄：cd daisys-mcp

3. 安裝 uv（Python 套件管理器），使用 curl -LsSf https://astral.sh/uv/install.sh | sh 安裝，或參考 uv 儲存庫 以取得其他安裝方式。

4. 建立虛擬環境並使用 uv 安裝相依套件：

uv venv
# source .venv/Scripts/activate (Windows)
source .venv/bin/activate (mac and linux)
uv pip install -e .

5. 在您的 MCP 客戶端（Claude Desktop、Cursor、mcp-cli、mcp-vscode 等）的設定檔中，加入以下內容：

{
    "mcpServers": {
        "daisys-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "{installation_path}/daisys-mcp",
                "run",
                "-m",
                "daisys_mcp.server"
            ],
            "env": {
                "DAISYS_EMAIL": "{Your Daisys Email}",
                "DAISYS_PASSWORD": "{Your Daisys Password}",
                "DAISYS_BASE_STORAGE_PATH": "{Path where you want to store your audio files}"
            }
        }
    }
}

常見問題

若在 Linux 上遇到 portaudio 相關問題，可嘗試手動安裝：

sudo apt-get update
sudo apt-get install -y portaudio19-dev

貢獻

若您想貢獻或從原始碼執行：

1. 複製儲存庫：

git clone https://github.com/daisys-ai/daisys-mcp.git
cd daisys_mcp

2. 建立虛擬環境並使用 uv 安裝相依套件：

uv venv
source .venv/bin/activate
uv pip install -e .
uv pip install -e ".[dev]"

3. 將 .env.example 複製為 .env，並加入您的 DAISYS 使用者名稱與密碼：

cp .env.example .env
# Edit .env and add your DAISYS username and password

4. 透過執行測試來測試伺服器：

uv run pytest

您也可以使用以下指令執行完整的整合測試：

uv run pytest -m 'requires_credentials' # ⚠️ Running full integration tests does costs tokens on the Daisys platform 

5. 使用 MCP Inspector 在本機進行除錯與測試：uv run mcp dev daisys_mcp/server.py