让 Agent 接上 YApi、Yuque、数据库、Redis 和日志:我的 MCP 资源绑定设计

Agent 不能只会读文件,还要能安全地连接真实的研发资源:接口文档、知识库、数据库、缓存、日志。

但连接外部资源必须解决两个问题:① 怎么知道用户需要哪个资源?② 怎么保证安全?

一、触发词检测

当用户的提示词中出现以下关键词时,Agent 在执行实际操作前先激活 Resource Binding:

资源类型 触发关键词
YApi yapi、接口文档、接口同步、API 文档、YApi URL
语雀 语雀、yuque、设计文档、文档同步、语雀 URL
数据库 数据库、database、DB、SQL、数据表、表结构
Redis redis、缓存、cache、缓存逻辑
日志 SLS、日志、traceId、排查
综合 对接、联调、数据流转、全链路

二、配置优先级

复制代码
用户当前输入  (最高)
    ↓
全局配置      ~/.sdd-agent/resource-config.json
    ↓
项目配置      yapi-projects.json / yuque-config.json
    ↓
环境变量      (最低)

三、配置文件结构

复制代码
{
  "yapi": {
    "baseUrl": "https://yapi.example.com",
    "projects": []
  },
  "yuque": {
    "baseUrl": "https://www.yuque.com",
    "repos": []
  },
  "database": {
    "defaultSource": "uat",
    "sources": []
  },
  "redis": {
    "defaultSource": "uat",
    "sources": []
  }
}

**⚠️ 安全规则:**resource-config.json 不进仓库,包含秘钥和连接信息。仓库中只保留 resource-config.json.example 模板。

四、安全边界

资源 安全策略
秘钥/Token 不进仓库,通过全局配置或环境变量管理
生产数据库 默认禁写,只允许 SELECT 语句
Redis UAT 环境默认,生产环境需显式确认
日志查询 结果自动脱敏手机号、身份证号
AI 工具配置 .claude/ .codex/ .cursor/ .mcp.json 等必须加入 .gitignore

五、.gitignore 配置

复制代码
# AI model tool local configs (do not commit)
.claude/
.claude.json
.codex/
.cursor/
.cursorignore
.mcp.json
resource-config.json

六、实际使用场景

场景 Agent 动作
用户提到 YApi 链接 解析 projectId + apiId → 调用 MCP 获取接口定义 → 填充到 design.md
用户提到语雀文档 解析 namespace + slug → 读取文档内容 → 作为历史设计参考
用户要验证 SQL 使用默认 UAT 数据源 → 执行 SELECT → 返回表结构和数据
用户要检查 Redis 连接 UAT Redis → 查看 key 类型/TTL/内存 → 输出分析
用户给 traceId 排查 调用 SLS 查询日志 → 提取调用链路 → 分析耗时和异常

七、流程图

复制代码
用户提示词
  ↓
资源关键词检测
  ↓
MCP 服务可用性检查
  ↓
┌────────────────────────────────────────┐
│ 有配置 → 加载配置 → 继续执行           │
│ 无配置 → 提示用户提供或自动读取        │
│          → 保存到全局配置              │
└────────────────────────────────────────┘
  ↓
执行下游任务(查 DB / 调 YApi / 读 Yuque...)

八、总结

MCP 资源绑定让 Agent 从"只能看文件"变成"能连接真实研发环境"。关键设计是:触发词检测自动激活、配置优先级清晰、安全边界严格(秘钥不入仓库、生产只读、日志脱敏)。

📌 下一篇预告: 让 Agent 记住项目经验------RESOURCE_INDEX、别名标签和知识沉淀闭环

你的 Agent 能直接查数据库和日志吗?评论区聊聊你的 MCP 配置经验。

觉得有用请点赞收藏。

相关推荐
龙腾AI白云1 小时前
数字孪生与计算机视觉:让机器看懂现场
大数据·数据库·机器学习·知识图谱·pygame
Flynn Liang2 小时前
Java 序列化也能成为瓶颈:Jackson、Protobuf 与 Redis 序列化的生产实践
java·redis·性能优化·jackson·序列化·protobuf
千寻技术帮2 小时前
基于Spring Boot+Vue的农产品销售管理系统(源码+文档+数据库,附部署教程)
java·数据库·spring boot·后端·mysql·vue
千寻技术帮3 小时前
50055_基于AI的互帮互助小程序(源码+文档+数据库脚本+部署教程)
数据库·人工智能·小程序·毕业设计·springboot·课程设计
我不会起名字3223 小时前
分布式 ID:雪花、号段与 Redis 自增的 3 个取舍
redis·雪花算法·分布式 id·号段
CoderYanger4 小时前
Java EE 进阶:9.MyBatis 操作数据库(进阶)(第七弹):图书管理系统(强制登录)
java·数据库·spring boot·spring·java-ee·tomcat·mybatis
Flynn Liang4 小时前
多智能体协同不再复杂:Redis Stream 消费者组、幂等与故障恢复
数据库·人工智能·redis·缓存·ai agent·智能体
倔强的胡萝卜5 小时前
基于STM32F103C8T6的温湿度报警器设计
数据库·stm32·mongodb
Decay__12 小时前
PostgreSQL 数据库全栈运维实战系列 — 合集索引(24 篇)
运维·数据库·sql·mysql·架构
琳少_16 小时前
java程序开发笔记
java·开发语言·数据库·笔记