SuperAPI AI 工具集

linear

智能体与模型

查看项目

更新于 10-16 00:05

技能介绍

用途:当需要通过自动生成的异步 Python 应用操作 Linear、在代码中调用其 MCP 后端函数,或使用 mcp-skill CLI 查看可用函数时,使用本技能。

认证:服务器要求时可用 MCP 客户端内置 OAuth 流程。多数情况下直接使用默认构造函数即可:app = LinearApp()。令牌会持久化到 ~/.mcp-skill/auth/,后续运行自动复用凭据。如需自定义 OAuth 提供方,可通过 auth 参数传入:app = LinearApp(auth=my_oauth_provider)。

依赖:本技能需要 Python 包 mcp-skill。用 uv 安装:uv pip install mcp-skill;或用 pip 安装:pip install mcp-skill。

Python 用法:在异步 Python 代码中直接使用生成的应用。示例:import asyncio; from linear.app import LinearApp; async def main(): app = LinearApp(); result = await app.get_attachment(id="example"); print(result); asyncio.run(main())

异步注意事项:每个生成的工具方法都是 async,必须用 await 调用;在 async 函数内使用,脚本中通过 asyncio.run(...) 执行。忘记 await 会得到 coroutine 对象而非实际结果。与 notebook、Web 服务器或异步框架等事件循环环境混用时要小心。

用 CLI 发现函数:uvx mcp-skill list-apps;uvx mcp-skill list-functions linear;uvx mcp-skill inspect linear get_attachment。

导入路径:需将 .agents/skills 加入 Python 路径,例如 import sys; sys.path.insert(0, ".agents/skills"); from linear.app import LinearApp,或设置 PYTHONPATH=".agents/skills:$PYTHONPATH"。推荐使用 uv run 自动处理依赖,也可先 pip install mcp-skill 再用 python 直接运行。