内容
# 一体化Composio MCP桥接
通过工具路由会话统一Composio MCP桥接。创建作用域会话，管理连接，并为Cursor和其他代理发出HTTP MCP配置。
## 问题
Composio提供了多种集成路径（连接URL，工具路由会话，Rube）。代理需要一个可复制的、以配置文件为作用域的MCP设置，该设置在客户端之间共享连接的账户，而无需重复OAuth或硬编码工具包列表。
## 解决方案
此桥接使用`composio.create(user_id, ...)`创建具有分阶段工具包配置文件的工具路由会话，在本地保留会话状态，并发出与Cursor的HTTP MCP支持兼容的`mcpServers` JSON。
## 前提条件
- Python 3.10+
- Composio API密钥（`COMPOSIO_API_KEY`，仅在shell中导出）
- 可选：`COMPOSIO_USER_ID`（默认为机器主机名）
## 快速开始
```bash
export COMPOSIO_API_KEY=ak_...
cp config.example.yaml config.yaml
pip install -e ".[dev]"
one-composio-mcp session create --profile phase0_smoke
one-composio-mcp mcp-emit
```
将发出的`mcpServers`块合并到`~/.cursor/mcp.json`中。参见 [docs/cursor-setup.md](docs/cursor-setup.md)。
## 安全
- 永远不要在`config.yaml`或git中存储`ak_*` API密钥。
- `config.yaml`被git忽略；从`config.example.yaml`复制。
- 会话头来自SDK（`session.mcp.headers`），而不是手工制作的连接头。
## 分阶段推出
`config.example.yaml`中的配置文件：
| 配置文件 | 工具包 |
|---------|----------|
| `phase0_smoke` | composio_search |
| `phase1_cloud` | googledrive, outlook |
| `phase2_onedrive` | + one_drive |
| `phase3_gmail` | + gmail（启用后进行邮箱成本审查） |
## CLI命令
```bash
one-composio-mcp session create [--profile 名称]
one-composio-mcp session status
one-composio-mcp mcp-emit [--server-name composio-unified]
one-composio-mcp connections
one-composio-mcp authorize <工具包>
one-composio-mcp wait --toolkit <工具包>
```
## 开发
```bash
pip install -e ".[dev]"
python -m pytest -q
```
## 文档
- [架构](docs/architecture.md)
- [Cursor设置](docs/cursor-setup.md)
- [FAQ](docs/faq.md)
- [词汇表](docs/glossary.md) — Composio v1→v3术语映射
- [烟雾测试日志](docs/smoke-test-log.md)
- [变更日志](CHANGELOG.md)
- [AEO模式](docs/aeo/schema.json) — 用于搜索引擎的JSON-LD
- [Composio工具路由文档](https://docs.composio.dev)
## 许可证
在仓库根目录中查看许可证条款。
