第十一册：MCP 协议与自动化

# 开发者需要手写这个函数，并告诉 AI 怎么调用它
def create_github_issue(repo, title, body, labels=None):
    """
    创建 GitHub Issue
    参数：
      repo: 仓库名，格式 "owner/repo"
      title: Issue 标题
      body: Issue 内容
      labels: 标签列表，可选
    """
    headers = {
        "Authorization": f"token {GITHUB_TOKEN}",
        "Accept": "application/vnd.github.v3+json"
    }
    data = {"title": title, "body": body}
    if labels:
        data["labels"] = labels
    response = requests.post(
        f"https://api.github.com/repos/{repo}/issues",
        headers=headers,
        json=data
    )
    return response.json()
 
# 然后还要在系统提示词里告诉 AI：
# "如果你需要创建 GitHub Issue，调用 create_github_issue 函数，
#  参数 repo 必须是 owner/repo 格式..."

# 配置文件中只需这一行
mcp_servers:
  github:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "${GITHUB_TOKEN}"

# stdio 模式配置示例
mcp_servers:
  github:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "${GITHUB_TOKEN}"

# HTTP/SSE 模式配置示例
mcp_servers:
  remote-github:
    url: "https://mcp.example.com/github"
    headers:
      Authorization: "Bearer ${MCP_API_KEY}"
    # 是否使用 SSE 接收推送
    sse: true

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_issue",
    "arguments": {
      "repo": "owner/repo",
      "title": "发现 Bug",
      "body": "详情如下..."
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Issue #42 已成功创建: https://github.com/owner/repo/issues/42"
      }
    ],
    "isError": false
  }
}

{
  "jsonrpc": "2.0",
  "method": "notifications/resources/updated",
  "params": {
    "uri": "file:///project/src/main.py"
  }
}

// Client 请求
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}
 
// Server 响应
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "create_issue",
        "description": "在指定仓库创建一个新的 GitHub Issue",
        "inputSchema": {
          "type": "object",
          "properties": {
            "repo": {
              "type": "string",
              "description": "仓库名，格式：owner/repo"
            },
            "title": {
              "type": "string",
              "description": "Issue 标题"
            },
            "body": {
              "type": "string",
              "description": "Issue 内容"
            },
            "labels": {
              "type": "array",
              "items": {"type": "string"},
              "description": "标签列表"
            }
          },
          "required": ["repo", "title"]
        }
      },
      {
        "name": "search_issues",
        "description": "搜索 GitHub Issues",
        "inputSchema": {
          "type": "object",
          "properties": {
            "repo": {"type": "string"},
            "query": {"type": "string"},
            "state": {
              "type": "string",
              "enum": ["open", "closed", "all"]
            }
          },
          "required": ["repo", "query"]
        }
      }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "create_issue",
    "arguments": {
      "repo": "mycompany/project",
      "title": "首页加载速度过慢",
      "body": "在 3G 网络下，首页加载需要 8 秒以上..."
    }
  }
}

# ~/.hermes/config.yaml
 
mcp_servers:
  # Server 名称（自定义，用于标识）
  github:
    # stdio 模式配置
    command: "npx"
    args:
      - "-y"
      - "@modelcontextprotocol/server-github"
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "${GITHUB_TOKEN}"
    # 允许 AI 调用的工具列表（权限控制）
    allowed_tools:
      - "search_repositories"
      - "create_issue"
      - "search_issues"
      - "get_issue"
 
  # 另一个 Server
  notion:
    command: "npx"
    args:
      - "-y"
      - "@modelcontextprotocol/server-notion"
    env:
      NOTION_API_TOKEN: "${NOTION_TOKEN}"
    allowed_tools: []
 
  # HTTP 模式的 Server
  remote-tools:
    url: "https://mcp.internal.company.com/tools"
    headers:
      Authorization: "Bearer ${INTERNAL_API_KEY}"
    sse: true
    allowed_tools:
      - "query_database"
      - "send_notification"

mcp_servers:
  # GitHub MCP Server
  github:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "${GITHUB_TOKEN}"
    allowed_tools:
      - "search_repositories"
      - "get_file_contents"
      - "create_issue"
      - "search_issues"
      - "create_pull_request"
      - "list_commits"
 
  # Notion MCP Server
  notion:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-notion"]
    env:
      NOTION_API_TOKEN: "${NOTION_TOKEN}"
    allowed_tools: []
 
  # PostgreSQL MCP Server
  postgres:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-postgres"]
    env:
      POSTGRES_URL: "${DATABASE_URL}"
    allowed_tools:
      - "query"
 
  # File System MCP Server（访问本地文件）
  filesystem:
    command: "npx"
    args:
      [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Documents",
      ]
    allowed_tools:
      - "read_file"
      - "list_directory"
      - "search_files"

mcp_servers:
  # 公司内部 MCP 服务
  company-tools:
    url: "https://mcp.internal.company.com/v1"
    headers:
      Authorization: "Bearer ${COMPANY_MCP_TOKEN}"
      X-Department: "engineering"
    sse: true
    allowed_tools:
      - "query_employee"
      - "book_meeting_room"
      - "request_leave"
 
  # 第三方 MCP 托管服务
  mcp-cloud:
    url: "https://api.mcp.cloud/v1/github"
    headers:
      X-API-Key: "${MCP_CLOUD_KEY}"
    sse: false
    allowed_tools: []

mcp_servers:
  github:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "${GITHUB_TOKEN}"
    # 只允许读操作，禁止创建/修改
    allowed_tools:
      - "search_repositories"
      - "get_file_contents"
      - "search_issues"
      - "list_commits"
      - "get_commit"

mcp_servers:
  github-readonly:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "${GITHUB_READONLY_TOKEN}"
    allowed_tools:
      - "search_repositories"
      - "get_file_contents"
      - "search_issues"
 
  github-write:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "${GITHUB_WRITE_TOKEN}"
    allowed_tools:
      - "create_issue"
      - "create_pull_request"
      - "create_branch"

mcp_servers:
  dangerous-server:
    command: "npx"
    args: ["-y", "some-risky-server"]
    # 空数组 = 禁止所有工具
    allowed_tools: []

mcp_servers:
  github:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "${GITHUB_TOKEN}"
 
  notion:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-notion"]
    env:
      NOTION_API_TOKEN: "${NOTION_TOKEN}"
 
  slack:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-slack"]
    env:
      SLACK_BOT_TOKEN: "${SLACK_BOT_TOKEN}"

# ~/.hermes/config.yaml
 
mcp_servers:
  github:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "${GITHUB_TOKEN}"
    # 根据你的需求选择允许的工具
    allowed_tools:
      # 仓库操作
      - "search_repositories"
      - "get_file_contents"
      - "list_branches"
      # Issue 操作
      - "search_issues"
      - "get_issue"
      - "create_issue"
      - "update_issue"
      - "add_issue_comment"
      # PR 操作
      - "create_pull_request"
      - "get_pull_request"
      - "list_pull_requests"
      - "merge_pull_request"
      # Commit 操作
      - "list_commits"
      - "get_commit"
      # 搜索
      - "search_code"

# 保存到环境变量
export GITHUB_TOKEN="ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# 1. 使用环境变量（基础）
export GITHUB_TOKEN="ghp_xxx"
 
# 2. 使用 GitHub CLI（推荐）
gh auth login
# 然后用 `gh auth token` 获取 Token
 
# 3. 使用 1Password CLI（最安全）
export GITHUB_TOKEN=$(op read "op://Private/GitHub/PAT")
 
# 4. 定期轮换（最佳实践）
# 设置日历提醒，每 90 天重置一次 Token

export NOTION_TOKEN="secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

mcp_servers:
  notion:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-notion"]
    env:
      NOTION_API_TOKEN: "${NOTION_TOKEN}"
    allowed_tools:
      # 页面操作
      - "notion_search"
      - "notion_retrieve_page"
      - "notion_retrieve_block_children"
      # 数据库操作
      - "notion_query_database"
      - "notion_create_database_item"
      # 写入操作（谨慎开启）
      - "notion_append_block_children"
      - "notion_update_page"

mcp_servers:
  notion-readonly:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-notion"]
    env:
      NOTION_API_TOKEN: "${NOTION_TOKEN}"
    allowed_tools:
      - "notion_search"
      - "notion_retrieve_page"
      - "notion_retrieve_block_children"
      - "notion_query_database"

mcp_servers:
  notion-write:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-notion"]
    env:
      NOTION_API_TOKEN: "${NOTION_TOKEN}"
    allowed_tools:
      - "notion_search"
      - "notion_retrieve_page"
      - "notion_query_database"
      - "notion_create_database_item"
      - "notion_append_block_children"
      - "notion_update_page"

mcp_servers:
  linear:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-linear"]
    env:
      LINEAR_API_KEY: "${LINEAR_API_KEY}"
    allowed_tools:
      - "linear_search_issues"
      - "linear_create_issue"
      - "linear_update_issue"
      - "linear_add_comment"

mcp_servers:
  figma:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-figma"]
    env:
      FIGMA_ACCESS_TOKEN: "${FIGMA_TOKEN}"
    allowed_tools:
      - "get_file"
      - "get_file_nodes"
      - "get_comments"

mcp_servers:
  slack:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-slack"]
    env:
      SLACK_BOT_TOKEN: "${SLACK_BOT_TOKEN}"
      SLACK_TEAM_ID: "${SLACK_TEAM_ID}"
    allowed_tools:
      - "slack_search_messages"
      - "slack_send_message"
      - "slack_get_channel_history"

mcp_servers:
  google-calendar:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-gcalendar"]
    env:
      GOOGLE_CLIENT_ID: "${GOOGLE_CLIENT_ID}"
      GOOGLE_CLIENT_SECRET: "${GOOGLE_CLIENT_SECRET}"
      GOOGLE_REFRESH_TOKEN: "${GOOGLE_REFRESH_TOKEN}"
    allowed_tools:
      - "list_events"
      - "create_event"
      - "delete_event"
      - "find_free_time"

mcp_servers:
  google-drive:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-gdrive"]
    env:
      GOOGLE_CLIENT_ID: "${GOOGLE_CLIENT_ID}"
      GOOGLE_CLIENT_SECRET: "${GOOGLE_CLIENT_SECRET}"
      GOOGLE_REFRESH_TOKEN: "${GOOGLE_REFRESH_TOKEN}"
    allowed_tools:
      - "search_files"
      - "read_file"
      - "list_folder"

mcp_servers:
  postgres:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-postgres"]
    env:
      POSTGRES_URL: "${DATABASE_URL}"
    allowed_tools:
      - "query"

export DATABASE_URL="postgresql://username:password@localhost:5432/dbname"

# ~/.hermes/cron/tasks.yaml
 
# 全局配置
global:
  # 时区设置
  timezone: "Asia/Shanghai"
  # 任务并发数
  max_concurrent: 3
  # 默认超时时间
  default_timeout: 300
  # 失败重试次数
  default_retries: 2
  # 通知渠道（任务完成/失败时通知你）
  notifications:
    on_success: false # 成功时不通知（避免打扰）
    on_failure: true # 失败时通知
    channels:
      - platform: "telegram"
        user_id: "12345678"
 
# 任务列表
tasks:
  # 任务1：每日新闻摘要
  - id: "daily-news"
    name: "每日 AI 新闻摘要"
    # Cron 表达式：每天早上 8 点执行
    schedule: "0 8 * * *"
    enabled: true
    # 执行内容
    actions:
      - type: "prompt"
        content: |
          搜索今天的人工智能领域重要新闻，
          整理成 5 条要点，每条包含标题和一句话摘要。
          用中文输出。
      - type: "notify"
        platform: "telegram"
        user_id: "12345678"
        message_template: "📰 今日 AI 新闻\n\n{{result}}"
 
  # 任务2：每周报告生成
  - id: "weekly-report"
    name: "每周数据报告"
    schedule: "0 9 * * MON"
    enabled: true
    actions:
      - type: "mcp"
        server: "postgres"
        tool: "query"
        arguments:
          sql: |
            SELECT 
              DATE(created_at) as date,
              COUNT(*) as new_users
            FROM users
            WHERE created_at >= NOW() - INTERVAL '7 days'
            GROUP BY DATE(created_at)
            ORDER BY date;
      - type: "prompt"
        content: |
          根据以下数据生成周报摘要：
          {{previous_result}}
 
          要求：
          1. 总结本周关键数据
          2. 指出趋势和异常
          3. 给出下周建议
      - type: "notify"
        platform: "lark"
        user_id: "ou_xxxxxxxx"
 
  # 任务3：网站监控
  - id: "website-monitor"
    name: "网站可用性监控"
    # 每 5 分钟执行一次
    schedule: "*/5 * * * *"
    enabled: true
    timeout: 30
    actions:
      - type: "http"
        method: "GET"
        url: "https://myapp.com/health"
        expected_status: 200
      - type: "condition"
        if: "{{status}} != 200"
        then:
          - type: "notify"
            platform: "telegram"
            user_id: "12345678"
            message_template: "🚨 网站异常！状态码: {{status}}"

- id: "news-digest"
  name: "每日行业新闻"
  schedule: "0 8 * * *"
  enabled: true
  actions:
    - type: "prompt"
      content: |
        搜索今天 {{date}} 的 {{industry}} 行业重要新闻。
        整理成 3-5 条要点，每条包含：
        - 标题（加粗）
        - 一句话摘要
        - 来源链接
 
        用中文输出，格式清晰易读。
    - type: "notify"
      platform: "telegram"
      user_id: "12345678"
      message_template: |
        📰 {{date}} 行业新闻
 
        {{result}}

- id: "daily-report"
  name: "每日数据简报"
  schedule: "0 9 * * *"
  actions:
    - type: "mcp"
      server: "postgres"
      tool: "query"
      arguments:
        sql: |
          SELECT 
            COUNT(*) FILTER (WHERE created_at >= CURRENT_DATE) as today,
            COUNT(*) FILTER (WHERE created_at >= CURRENT_DATE - 1) as yesterday
          FROM orders;
    - type: "prompt"
      content: |
        基于以下数据生成今日简报：
        {{previous_result}}
 
        格式要求：
        📊 今日数据简报 ({{date}})
 
        订单数: X 单（环比昨日 ±X%）
        ...
    - type: "notify"
      platform: "lark"

- id: "health-check"
  name: "服务健康检查"
  schedule: "*/5 * * * *"
  timeout: 10
  actions:
    - type: "http"
      method: "GET"
      url: "https://api.myapp.com/health"
    - type: "condition"
      if: "{{status}} != 200 or {{response_time}} > 2000"
      then:
        - type: "notify"
          platform: "telegram"
          message_template: |
            🚨 服务异常告警
 
            时间: {{timestamp}}
            状态码: {{status}}
            响应时间: {{response_time}}ms
 
            请立即检查！

- id: "social-post"
  name: "定时发布内容"
  schedule: "0 10,15 * * *"
  actions:
    - type: "prompt"
      content: |
        生成一条关于 {{topic}} 的社交媒体帖子。
        平台: 微信公众号
        风格: 专业但亲切
        字数: 300-500 字
        包含一个相关话题标签。
    - type: "notify"
      platform: "telegram"
      message_template: |
        📝 待发布内容：
 
        {{result}}
 
        请审核后手动发布。

- id: "competitor-monitor"
  name: "竞品动态监控"
  schedule: "0 9 * * *"
  actions:
    - type: "prompt"
      content: |
        搜索 {{competitor}} 最近 24 小时的动态：
        1. 新产品/功能发布
        2. 官方博客更新
        3. 社交媒体重要发文
        4. 融资/合作新闻
 
        整理成简报，标记需要关注的重要信息。
    - type: "notify"
      platform: "lark"

# 查看 cron 帮助
$ hermes cron --help
 
Usage: hermes cron [OPTIONS] COMMAND [ARGS]...
 
  管理定时任务
 
Commands:
  list       列出所有任务
  run        手动执行一个任务
  enable     启用任务
  disable    禁用任务
  logs       查看任务执行日志
  validate   验证配置文件语法

# 列出所有任务
$ hermes cron list
 
输出示例：
ID              NAME                SCHEDULE        STATUS    LAST_RUN
─────────────────────────────────────────────────────────────────────
daily-news      每日 AI 新闻摘要     0 8 * * *       ✓ 启用    2小时前
weekly-report   每周数据报告         0 9 * * MON     ✓ 启用    3天前
website-monitor 网站可用性监控        */5 * * * *     ✓ 启用    5分钟前
 
# 手动执行一个任务（调试用）
$ hermes cron run daily-news
 
# 启用/禁用任务
$ hermes cron enable daily-news
$ hermes cron disable weekly-report
 
# 查看任务日志
$ hermes cron logs daily-news --tail 20
 
# 验证配置文件语法
$ hermes cron validate
 
# 实时监控任务执行
$ hermes cron logs --follow

$ hermes cron validate
 
✅ 配置文件语法正确
  任务数: 5
  启用: 4, 禁用: 1
  警告:
    - 任务 "backup-db" 没有设置超时时间，将使用默认值 300 秒

$ hermes cron run daily-news --verbose
 
🔄 手动执行任务: daily-news
────────────────────────────────────
步骤1: prompt - 执行中...
✓ 步骤1完成 (耗时 3.2s)
步骤2: notify - 执行中...
✓ 步骤2完成 (耗时 0.5s)
────────────────────────────────────
任务完成，总计耗时 3.7s

# 查看最近失败的执行
$ hermes cron logs --status failed --last 24h
 
# 查看特定任务的详细日志
$ hermes cron logs website-monitor --tail 50

# 在任务配置中使用 delegate_task
- id: "complex-analysis"
  name: "复杂投研分析"
  actions:
    - type: "delegate"
      # 最多 3 个子 Agent 并行
      max_workers: 3
      tasks:
        - id: "market-research"
          name: "市场调研"
          prompt: |
            分析 {{company}} 所在行业的市场规模、增长趋势、
            竞争格局。重点关注最近一年的变化。
 
        - id: "financial-analysis"
          name: "财务分析"
          prompt: |
            分析 {{company}} 的财务报表：
            - 营收和利润趋势
            - 现金流状况
            - 关键财务比率
 
        - id: "tech-assessment"
          name: "技术评估"
          prompt: |
            评估 {{company}} 的技术实力：
            - 核心技术和专利
            - 技术团队规模和质量
            - 技术护城河
 
      # 汇总结果
      merge_prompt: |
        将以下三个维度的分析结果整合成一份完整的投研报告：
 
        ## 市场调研
        {{market-research.result}}
 
        ## 财务分析
        {{financial-analysis.result}}
 
        ## 技术评估
        {{tech-assessment.result}}
 
        要求：
        1. 给出综合评分（1-10）
        2. 指出关键风险点
        3. 给出投资建议

- id: "investment-research"
  name: "AI 投研报告生成"
  schedule: "0 7 * * MON"
  actions:
    - type: "delegate"
      max_workers: 3
      tasks:
        - id: "collect-data"
          name: "数据收集"
          prompt: |
            收集 {{target_company}} 的最新公开信息：
            1. 搜索最近一周的新闻
            2. 查找最新财报数据
            3. 收集行业研报摘要
 
        - id: "sentiment-analysis"
          name: "舆情分析"
          prompt: |
            分析 {{target_company}} 的市场情绪：
            1. 社交媒体讨论热度
            2. 分析师评级变化
            3. 投资者情绪指标
 
        - id: "peer-comparison"
          name: "同业对比"
          prompt: |
            将 {{target_company}} 与主要竞品对比：
            1. 市值和估值对比
            2. 营收增速对比
            3. 技术实力对比
 
      merge_prompt: |
        基于收集的数据、舆情分析和同业对比，
        生成一份专业的投研报告，包含：
        - 执行摘要
        - 核心数据
        - 风险评估
        - 投资建议
 
    - type: "notify"
      platform: "lark"
      message_template: |
        📊 投研报告已生成
 
        标的: {{target_company}}
        生成时间: {{timestamp}}
 
        {{result}}

- id: "content-factory"
  name: "自动化内容生产"
  actions:
    - type: "delegate"
      max_workers: 3
      tasks:
        - id: "topic-research"
          name: "选题研究"
          prompt: |
            基于热点事件 {{event}}，
            生成 5 个适合社交媒体传播的内容选题。
            每个选题包含：标题角度、目标平台、预期效果。
 
        - id: "content-draft"
          name: "内容起草"
          prompt: |
            为选题 "{{topic}}" 撰写完整内容：
            - 微信公众号版本（800 字）
            - 小红书版本（300 字+表情）
            - Twitter 版本（280 字）
 
        - id: "visual-design"
          name: "配图建议"
          prompt: |
            为内容 "{{topic}}" 设计配图方案：
            - 主视觉描述（供设计师参考）
            - 信息图数据点
            - 配色建议
 
      merge_prompt: |
        整合选题、内容和配图方案，
        输出完整的内容发布计划表。

- id: "code-review-pipeline"
  name: "自动化代码审查"
  # 监听 GitHub Webhook，PR 创建时触发
  trigger:
    type: "webhook"
    source: "github"
    event: "pull_request.opened"
  actions:
    - type: "delegate"
      max_workers: 3
      tasks:
        - id: "security-check"
          name: "安全检查"
          prompt: |
            审查 PR {{pr_url}} 的安全问题：
            - SQL 注入风险
            - XSS 漏洞
            - 敏感信息泄露
            - 依赖包漏洞
 
        - id: "quality-check"
          name: "代码质量"
          prompt: |
            审查 PR {{pr_url}} 的代码质量：
            - 代码复杂度
            - 测试覆盖率
            - 代码风格一致性
            - 设计模式使用
 
        - id: "logic-check"
          name: "业务逻辑"
          prompt: |
            审查 PR {{pr_url}} 的业务逻辑：
            - 需求实现是否完整
            - 边界条件处理
            - 异常处理
            - 性能影响
 
      merge_prompt: |
        整合三方审查意见，生成完整的代码审查报告。
        按严重程度分类，给出明确的修改建议。
 
    - type: "mcp"
      server: "github"
      tool: "add_issue_comment"
      arguments:
        repo: "{{repo}}"
        issue_number: "{{pr_number}}"
        body: "{{result}}"

# ~/.hermes/cron/tasks.yaml
 
- id: "auto-research-pipeline"
  name: "全自动投研流水线"
  # 每天开盘前执行
  schedule: "0 8 * * MON-FRI"
  enabled: true
  timeout: 600
  actions:
    # 步骤1：并行数据收集（3 个子 Agent）
    - type: "delegate"
      max_workers: 3
      tasks:
        - id: "market-data"
          name: "市场数据"
          prompt: |
            获取今日市场数据：
            - 大盘指数（上证、深证、创业板）
            - 北向资金流向
            - 涨跌停家数
            - 板块涨跌排名
 
        - id: "news-scan"
          name: "新闻扫描"
          prompt: |
            扫描今日重要财经新闻：
            - 政策面消息
            - 行业动态
            - 个股公告
            - 国际市场影响
 
        - id: "technical-analysis"
          name: "技术面"
          prompt: |
            分析自选股的技术面：
            - K线形态
            - 均线系统
            - MACD/KDJ 指标
            - 支撑压力位
 
      merge_prompt: |
        将市场数据、新闻扫描和技术面分析汇总，
        生成早盘简报。
 
    # 步骤2：保存到 Notion
    - type: "mcp"
      server: "notion"
      tool: "notion_append_block_children"
      arguments:
        page_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
        children:
          - type: "heading_2"
            text: "{{date}} 早盘简报"
          - type: "paragraph"
            text: "{{previous_result}}"
 
    # 步骤3：发送到飞书群
    - type: "notify"
      platform: "lark"
      channel: "投研群"
      message_template: |
        📊 {{date}} 早盘简报已生成
 
        已保存至 Notion 知识库。
        重点关注的板块：{{highlight_sectors}}
 
        点击查看详情

- id: "content-factory-pipeline"
  name: "全自动内容工厂"
  schedule: "0 6 * * *"
  actions:
    # 步骤1：确定今日选题
    - type: "prompt"
      content: |
        基于今天的日期 {{date}} 和热点事件，
        为科技自媒体账号确定 3 个内容选题。
        要求：
        - 与 AI/科技相关
        - 有话题性和传播潜力
        - 适合公众号+小红书双平台发布
 
    # 步骤2：为每个选题并行生产内容
    - type: "delegate"
      max_workers: 3
      tasks:
        - id: "content-1"
          name: "选题1内容"
          prompt: |
            为选题 "{{topics[0]}}" 撰写：
            1. 公众号文章（1000 字，专业深度）
            2. 小红书笔记（300 字，轻松活泼）
            3. 配图描述（3 张图）
 
        - id: "content-2"
          name: "选题2内容"
          prompt: |
            为选题 "{{topics[1]}}" 撰写：
            1. 公众号文章
            2. 小红书笔记
            3. 配图描述
 
        - id: "content-3"
          name: "选题3内容"
          prompt: |
            为选题 "{{topics[2]}}" 撰写：
            1. 公众号文章
            2. 小红书笔记
            3. 配图描述
 
      merge_prompt: |
        整理三份内容的生产计划：
        - 发布时间表
        - 内容要点
        - 配图需求清单
 
    # 步骤3：保存到 Notion 发布日历
    - type: "mcp"
      server: "notion"
      tool: "notion_create_database_item"
      arguments:
        database_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
        properties:
          标题: "{{date}} 内容计划"
          状态: "待审核"
          内容: "{{result}}"
 
    # 步骤4：通知审核
    - type: "notify"
      platform: "telegram"
      message_template: |
        📝 今日内容已生成，请审核
 
        已保存至 Notion 发布日历。
        共 3 篇内容待审核。

- id: "reliable-pipeline"
  name: "带容错的流水线"
  actions:
    - type: "try"
      try:
        - type: "mcp"
          server: "github"
          tool: "search_issues"
          arguments:
            repo: "mycompany/project"
            query: "is:open label:bug"
      catch:
        - type: "notify"
          platform: "telegram"
          message_template: |
            ⚠️ 任务步骤失败
            任务: {{task_id}}
            步骤: GitHub 查询
            错误: {{error}}
 
            已跳过此步骤，继续执行后续任务。
 
    - type: "prompt"
      content: |
        基于获取的数据生成报告。
        如果数据为空，请说明"今日无新增 Bug"。
 
    # 最终通知，无论成功失败都发送
    - type: "notify"
      platform: "lark"
      message_template: |
        任务 {{task_id}} 执行完成
        状态: {{status}}
 
        {{#if error}}
        异常信息: {{error}}
        {{/if}}

global:
  notifications:
    on_failure: true
    escalation:
      # 第一次失败：立即通知
      - after: 0
        channels:
          - platform: "telegram"
            user_id: "12345678"
 
      # 连续失败 3 次：升级告警
      - after: 3
        channels:
          - platform: "lark"
            user_id: "ou_xxxxxxxx"
 
      # 连续失败 5 次：电话/短信告警
      - after: 5
        channels:
          - platform: "sms"
            phone: "+86138xxxxxxxx"

# GitHub：使用 Fine-grained Token，限定只读特定仓库
mcp_servers:
  github-readonly:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "${GITHUB_READONLY_TOKEN}"
    allowed_tools:
      - "search_repositories"
      - "get_file_contents"
      # 禁止所有写操作！
 
# 数据库：使用只读账号
mcp_servers:
  postgres:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-postgres"]
    env:
      # 这个 URL 连接的是只读副本，账号只有 SELECT 权限
      POSTGRES_URL: "${DATABASE_READONLY_URL}"

# 敏感信息只通过环境变量传入，不写入配置文件
export GITHUB_TOKEN="ghp_xxx"
export DATABASE_PASSWORD="secret"
export SLACK_BOT_TOKEN="xoxb-xxx"

global:
  security:
    # 日志中自动脱敏的模式
    log_redaction:
      - pattern: "ghp_[a-zA-Z0-9]{36}"
        replacement: "[GITHUB_TOKEN]"
      - pattern: "xoxb-[a-zA-Z0-9-]{10,}"
        replacement: "[SLACK_TOKEN]"
      - pattern: "password[=:]\s*\S+"
        replacement: "password=[REDACTED]"

global:
  audit:
    enabled: true
    log_file: "~/.hermes/logs/audit.log"
    # 记录所有 MCP 工具调用
    log_mcp_calls: true
    # 记录所有数据库查询
    log_database_queries: true

global:
  rate_limit:
    # 每个 MCP Server 的调用频率限制
    mcp:
      github:
        requests_per_minute: 30
        requests_per_hour: 500
      notion:
        requests_per_minute: 20
      openai:
        requests_per_minute: 60
 
    # 全局预算控制
    budget:
      daily_max_tokens: 1000000 # 每日最大 Token 数
      daily_max_cost_usd: 50 # 每日最大花费（美元）
      alert_threshold: 80 # 达到 80% 时告警

# 查看今日 API 使用情况
$ hermes stats --today
 
今日 API 使用情况
─────────────────────────────────
OpenAI API:
  请求数: 1,234
  Token 数: 456,789
  预估费用: $2.34
 
GitHub API:
  请求数: 567
  剩余额度: 4,433/5000
 
总计费用: $2.34
预算使用: 4.7%

global:
  audit:
    enabled: true
    # 审计日志存储
    storage:
      type: "file" # file, database, remote
      path: "~/.hermes/audit/"
      retention_days: 90 # 保留 90 天
 
    # 审计事件类型
    events:
      - "mcp.tool_called" # MCP 工具调用
      - "mcp.server_connected" # MCP Server 连接
      - "cron.task_executed" # 定时任务执行
      - "cron.task_failed" # 定时任务失败
      - "gateway.message_received" # 收到用户消息
      - "config.changed" # 配置变更
 
    # 审计日志格式
    format:
      include_timestamp: true
      include_user_id: true
      include_ip: false
      include_full_prompt: false # 不包含完整 prompt（隐私）

{
  "timestamp": "2024-01-15T08:00:00+08:00",
  "event": "mcp.tool_called",
  "level": "info",
  "user_id": "zhangsan",
  "details": {
    "server": "github",
    "tool": "create_issue",
    "arguments": {
      "repo": "mycompany/project",
      "title": "[REDACTED]"
    },
    "result": "success",
    "duration_ms": 1234
  }
}