用途:该技能用于通过生成的异步 Python 应用操作 Notion,在代码中调用其 MCP 支持的功能,或使用 mcp-skill CLI 查看可用函数。
主要能力:提供 NotionApp 类,示例方法为 notion_search,支持传入 query、query_type、content_search_mode 参数;所有生成的工具方法均为异步,需使用 await 调用。CLI 可列出应用、列出某应用的函数并查看指定函数的详情,例如:uvx mcp-skill list-apps、uvx mcp-skill list-functions notion、uvx mcp-skill inspect notion notion_search。
使用方式:需要安装 mcp-skill,可用 uv pip install mcp-skill 或 pip install mcp-skill。认证方面,服务器需要时应用可使用 MCP 客户端内置 OAuth 流程,默认构造函数通常足够,令牌持久化到 ~/.mcp-skill/auth/ 以便后续复用;也可通过 NotionApp(auth=my_oauth_provider) 传入自定义 OAuth 提供方。在脚本中使用时应将调用放入异步函数,再用 asyncio.run(...) 执行。导入前需把 .agents/skills 加入 Python 路径,例如 sys.path.insert(0, ".agents/skills") 或设置 PYTHONPATH=".agents/skills:$PYTHONPATH";推荐使用 uv run --with mcp-skill 自动处理依赖。
限制:忘记 await 会得到协程对象而非实际结果;与其他事件循环环境(如 notebook、Web 服务器或异步框架)混用需谨慎。资料未提供更多具体功能、平台支持、收费或效果信息。