内容
# iso-evidence-mcp
无需繁琐操作，收集审计证据。告诉 Claude Code 您正在处理的控制措施，它将：
**从 Notion 读取任务 → 在 GitHub 上截图证明 → 上传回 Notion 页面。**
为 ISO 27001 而建，但适用于任何“执行、证明、归档”的任务。
## 1. 安装
在 Claude Code 中：
```
/plugin marketplace add hung12ct/iso-evidence-mcp
/plugin install iso-evidence@iso-evidence-official
```
运行 `/mcp` — 您应该看到 **iso-evidence** 已连接。
## 2. 设置（一次）
```bash
# a) 安装 uv（运行服务器）
curl -LsSf https://astral.sh/uv/install.sh | sh
# b) 添加您的 Notion token（参见下面的“获取 Notion token”）
export NOTION_TOKEN=ntn_xxx # 添加到 ~/.zshrc 以保存它
# c) 登录 GitHub 一次（保存截图会话）
uvx --from git+https://github.com/hung12ct/iso-evidence-mcp.git iso-evidence login
```
## 3. 使用
只需询问 Claude Code：
> “从 `<notion-url>` 读取 A.8.29 任务，截图 Unit Tests Actions 运行和 PR 检查，并将它们附加到该页面。”
就这样。
---
### 获取 Notion token
1. 前往 <https://www.notion.so/my-integrations> → **新建集成** → 启用 **读取** + **插入内容**。
2. 将密钥 (`ntn_…`) 复制到 `NOTION_TOKEN`。
3. 打开您的 Notion 页面 → **•••** → **连接** → 添加集成。 *(跳过此步骤，您将收到 404 错误。)*
> **仅限工作区访客？** 创建/安装集成是工作区 **成员/管理员** 操作 — 访客通常无法执行步骤 1-3。您可以请工作区管理员创建集成并共享页面（然后使用上面的令牌），或者通过连接器登录 **为您** （例如 Claude Code 内置的 `claude.ai Notion` 连接器通过 `/mcp`），该连接器使用您自己的页面权限。
### 工具（Claude 使用的底层工具）
| 工具 | 功能 |
|---|---|
| `notion_get_task(page)` | 读取任务页面 |
| `github_screenshot(url)` | 截图登录的 GitHub 页面 |
| `notion_attach_evidence(page, images)` | 上传截图回页面 |
### 许可证
MIT。
