OMOS-MCP

MCP 服务器让 AI 代理（Claude、ChatGPT、Cursor 等）读取 OMOS Shared Drive 中的项目文档来回答问题 — 每个答案都引用源文件并附带 Google Drive 链接

支持的 Drive 结构：

OMOS/
├── Project A/
│   ├── Project Overview/
│   ├── Timeline/
│   ├── Design/
│   │   ├── System Flow/
│   │   ├── DB/
│   │   └── API/
│   └── BRD/
└── Project B/ ...

工具

代理按顺序搜索：过滤 Project Name → 未找到则查看 Project Overview 并向用户确认 → 继续询问是否涉及 Timeline | BRD | Design (System Flow / DB / API) → 问题过于宽泛时会反问以缩小范围（已内置于服务器指令中）

Related MCP server: brkt-gdrive-mcp

一次性设置：Service Account

服务器通过 service account 访问 Drive（无需每个人登录）：

1. 进入 console.cloud.google.com → 创建新项目（或使用现有项目）

2. APIs & Services → Library → 搜索 Google Drive API → 点击 Enable

3. IAM & Admin → Service Accounts → Create Service Account → 设置名称如 omos-mcp → 点击 Create（可跳过角色步骤，无需授予任何权限）

4. 进入创建的 service account → 标签页 Keys → Add Key → Create new key → JSON → 密钥文件将下载

5. 复制 service account 的电子邮件（格式为 omos-mcp@<project>.iam.gserviceaccount.com）并共享 Shared Drive / OMOS 文件夹，授予该邮箱 Viewer 权限

6. 找到根 OMOS 的 folder id：在浏览器中打开文件夹，查看 URL https://drive.google.com/drive/folders/<这是 id>

环境变量

本地运行

先安装 uv（curl -LsSf https://astral.sh/uv/install.sh | sh）

1) 设置 .env（服务器从仓库根目录自动加载）：

cp .env.example .env

编辑 .env，填入 OMOS_ROOT_FOLDER_ID 和密钥文件路径（例如将密钥文件放在 ./service-account.json — 已加入 gitignore）

2) 连接 Claude Code（stdio）：

claude mcp add omos -- uv run --directory "/path/to/OMOS-MCP" omos-mcp

Claude Desktop / Cursor / Windsurf — 在 MCP 配置中添加：

{
  "mcpServers": {
    "omos": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/OMOS-MCP", "omos-mcp"]
    }
  }
}

3) 测试： 向代理提问 "OMOS 中有哪些项目？" — 应返回项目列表及链接

（可选）在本地作为 HTTP 服务器运行： 在 .env 中启用 OMOS_AUTH_TOKEN，然后

uv run omos-mcp-http

端点位于 http://localhost:8000/mcp，连接方式：

claude mcp add --transport http omos http://localhost:8000/mcp -H "Authorization: Bearer <OMOS_AUTH_TOKEN>"

部署为 MCP link（Render）

1. 将此仓库推送到 GitHub（已包含 Dockerfile + render.yaml）

2. Render → New → Blueprint → 选择此仓库

3. 在仪表盘中设置环境变量：

   • OMOS_ROOT_FOLDER_ID = root OMOS 的文件夹 ID

   • GOOGLE_SERVICE_ACCOUNT_JSON = 整个 JSON 密钥文件的内容（直接粘贴）

   • OMOS_AUTH_TOKEN Render 自动生成 → 复制分发给团队

4. 部署完成后 → 端点为 https://<app>.onrender.com/mcp

用户连接：

claude mcp add --transport http omos https://<app>.onrender.com/mcp \
  -H "Authorization: Bearer <OMOS_AUTH_TOKEN>"

Cursor / VS Code：在 MCP 配置中添加 URL 和 header Authorization: Bearer <token>

供 Claude.ai / ChatGPT（网页版）使用 — OAuth

网页客户端没有输入 header 的地方，必须通过 OAuth 提供商（如 WorkOS AuthKit，免费支持最多 100 万用户）：

1. 注册 workos.com → 启用 AuthKit → 设置登录方式并限制仅团队成员

2. 仪表盘 → Connect → Configuration → 开启 Client ID Metadata Document 和 Dynamic Client Registration

3. 添加 Resource Indicator = https://<app>.onrender.com（不带 /mcp）

4. 在 Render 上额外设置 3 个环境变量：OAUTH_ISSUER = AuthKit 域名，OAUTH_AUDIENCE = https://<app>.onrender.com，PUBLIC_URL = https://<app>.onrender.com

5. 用户：Claude.ai → Settings → Connectors → Add custom connector → 输入 https://<app>.onrender.com/mcp → 通过 WorkOS 登录

OAuth 模式和 bearer token 可以共存 — 网页使用 OAuth，CLI 仍可使用 token

测试转换器

uv run python test_convert.py