【技术文档摘要】：

Daisys MCP 服务器

Daisys-mcp 是一个测试版，尚未发布稳定版本。但你可以通过以下步骤尝试使用它：

1. 在 Daisys 上注册一个账户，并创建用户名和密码。

如果你在 macOS 上运行，请执行以下命令：

brew install portaudio

如果你在 Linux 上运行，请执行以下命令：

sudo apt install portaudio19-dev libjack-dev

2. 将以下配置添加到你的 MCP 客户端中的 mcp 配置文件中（例如：Claude Desktop，Cursor，mcp-cli，mcp-vscode 等）：

{
  "mcpServers": {
    "daisys-mcp": {
      "command": "uvx",
      "args": ["daisys-mcp"],
      "env": {
        "DAISYS_EMAIL": "{您的 Daisys 邮箱}",
        "DAISYS_PASSWORD": "{您的 Daisys 密码}",
        "DAISYS_BASE_STORAGE_PATH": "{您希望存储音频文件的路径}"
      }
    }
  }
}

从源代码构建：

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 和 linux)
uv pip install -e .

5. 将以下内容添加到你的 MCP 客户端配置文件中（例如：Claude Desktop，Cursor，mcp-cli，mcp-vscode �- 等）：

{
    "mcpServers": {
        "daisys-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "{安装路径}/daisys-mcp",
                "run",
                "-m",
                "daisys_mcp.server"
            ],
            "env": {
                "DAISYS_EMAIL": "{您的 Daisys 邮箱}",
                "DAISYS_PASSWORD": "{您的 Daisys 密码}",
                "DAISYS_BASE_STORAGE_PATH": "{您希望存储音频文件的路径}"
            }
        }
    }
}

常见问题

如果在 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
# 编辑 .env 文件并添加你的 DAISYS 用户名和密码

4. 通过运行测试来测试服务器：

uv run pytest

你也可以运行完整的集成测试：

uv run pytest -m 'requires_credentials' # ⚠️ 运行完整的集成测试会在 Daisys 平台上消耗令牌

5. 使用 MCP Inspector 进行本地调试和测试：uv run mcp dev daisys_mcp/server.py