用途:通过生成的异步 Python 应用与 ClickUp 交互,从代码中调用其 MCP 支持的功能,或使用 mcp-skill CLI 查看可用函数。
认证:当服务器要求时,可使用 MCP 客户端内置的 OAuth 流程。多数情况下默认构造函数即可,令牌会持久化到 ~/.mcp-skill/auth/,后续运行自动复用同一凭据。默认写法为 app = ClickupApp();若需自定义 OAuth 提供方,可通过 auth 参数传入,如 app = ClickupApp(auth=my_oauth_provider)。
依赖与安装:需要 Python 包 mcp-skill,可使用 uv pip install mcp-skill 或 pip install mcp-skill 安装。
用法:在异步 Python 代码中直接使用生成的应用。所有生成的方法都是异步的,必须用 await 调用;在脚本中应放在异步函数内,再用 asyncio.run(...) 运行。若忘记 await,会得到协程对象而非实际结果。注意与其他事件循环环境(如 notebook、Web 服务器或异步框架)混用时的兼容问题。
发现函数:使用 CLI 查找可用应用、列出某应用的函数、调用前检查函数,例如 uvx mcp-skill list-apps、uvx mcp-skill list-functions clickup、uvx mcp-skill inspect clickup clickup_search。
导入路径:需将 .agents/skills 加入 Python 路径,例如在代码中执行 import sys; sys.path.insert(0, ".agents/skills"),再 from clickup.app import ClickupApp;或设置环境变量 export PYTHONPATH=".agents/skills:$PYTHONPATH"。
运行方式:推荐使用 uv run 自动处理依赖,例如 PYTHONPATH=.agents/skills uv run --with mcp-skill python -c "...";也可先 pip install mcp-skill,再用 PYTHONPATH=.agents/skills python -c "..." 运行。
限制:资料未提供具体功能范围、可用工具方法清单、速率限制、定价或平台支持细节,需通过 CLI inspect 查看具体函数。