用途:通过生成的异步 Python 应用与 Canva 交互,在代码中调用其 MCP 后端函数,或使用 mcp-skill CLI 查看可用函数。
主要能力:提供 CanvaApp 类及异步工具方法,例如 upload_asset_from_url(url="example", name="example", user_intent="example");支持 MCP 客户端内置 OAuth 流程,令牌默认持久化到 ~/.mcp-skill/auth/,后续运行自动复用;如需自定义 OAuth 提供方可传入 auth 参数:CanvaApp(auth=my_oauth_provider)。
依赖与使用方式:需安装 mcp-skill,可用 uv pip install mcp-skill 或 pip install mcp-skill。Python 中需导入 asyncio 和 from canva.app import CanvaApp,所有工具方法均为异步,调用时须使用 await,脚本中用 asyncio.run(...) 运行;若忘记 await 会得到协程对象而非结果。注意在 notebook、Web 服务器或其他异步框架中混用事件循环需谨慎。CLI 可用 uvx mcp-skill list-apps、uvx mcp-skill list-functions canva、uvx mcp-skill inspect canva upload_asset_from_url 查看应用、函数及函数详情。为正确导入,需将 .agents/skills 加入 Python 路径,例如 sys.path.insert(0, ".agents/skills"),或设置 export PYTHONPATH=".agents/skills:$PYTHONPATH";推荐用 uv run --with mcp-skill 自动处理依赖,也可先 pip install mcp-skill 再用 PYTHONPATH=.agents/skills python 运行。
适用场景与限制:适用于需要在异步 Python 代码中调用 Canva 相关 MCP 函数、上传素材等操作的场景。资料未提供具体可用函数完整列表、Canva 功能范围、计费、平台限制及额外使用步骤,暂未明确。