Composio教程:30.3k星1000+工具集MCP框架,给AI Agent预认证工具能力

📌 项目:ComposioHQ/composio | 星数:30.3k(2026-09-24) | 协议:MIT | 语言:TypeScript | GitHub

一句话定位:"1000+预认证工具集——让AI Agent从有想法到能执行,一个SDK搞定。" Composio提供1000+预认证工具集,覆盖GitHub、Slack、Gmail、Notion等主流服务,内置按用户会话管理、OAuth认证、事件触发器和代码沙箱,让Agent能真正执行操作。

🛠️ 1000+工具集架构

Composio SDK monorepo包含:

工具覆盖GitHub、Slack、Gmail、Notion、Linear、Jira等1000+服务,每个工具都预配置了认证流程。和 TradingView MCP 单一领域不同,Composio是跨领域工具集平台。

🔐 按用户会话 + 预认证

Composio的核心差异化是按用户会话管理——不同用户的Agent使用各自的OAuth令牌访问工具:

from composio import ComposioToolSet

toolset = ComposioToolSet(user_id="user_123")

# 获取已授权的GitHub工具
tools = toolset.get_tools(actions=["github_create_issue"])

# Agent使用工具创建issue
agent.run(
    "在repo.composio/composio创建bug issue",
    tools=tools
)

用户只需一次OAuth授权,后续Agent自动使用其令牌。Composio管理令牌存储和刷新。

🚀 快速开始

# TypeScript
npm install @composio/core

# Python
pip install composio

# 初始化
import { Composio } from "@composio/core";
const composio = new Composio({ apiKey: "your_api_key" });

# 搜索工具
const tools = await composio.tools.search("github");
console.log(`${tools.length} GitHub tools available`);

⚖️ 优缺点

✅ 优点⚠️ 不足
1000+预认证工具集,开箱即用需要Composio API Key(有免费层)
按用户会话管理OAuth部分工具依赖第三方API可用性
多框架适配器(OpenAI/Claude/Vercel/LangChain)TypeScript和Python SDK功能不完全对等
内置触发器和沙箱高级功能需付费计划
MIT协议,CLI工具方便调试

📚 常见问题

Composio是免费的吗?

有免费层(每月一定量工具调用),高级功能和大规模使用需付费。开源SDK本身MIT协议。

支持哪些Provider?

OpenAI Agents、Claude Agent SDK、Vercel AI SDK、LangChain、CrewAI等主流框架都有适配器。

如何处理OAuth认证?

Composio管理完整的OAuth流程。用户通过Composio的授权页面一次性授权,后续Agent自动使用刷新令牌。