bookworm-smart-assistant/docs/mcp-templates.md

# MCP 配置指南

## 按需模板 (写入项目 `.claude.json`)

### PostgreSQL MCP
- **触发词**: "连数据库"、"查表"、"跑 SQL"、"数据库调试"
- **配置**: 写入项目 `.claude.json`:
  ```json
  "postgres": {
    "args": ["/c", "npx", "-y", "@modelcontextprotocol/server-postgres", "<连接串>"],
    "command": "cmd", "type": "stdio"
  }
  ```
- **安全提醒**: 连接只读副本或开发库，避免直连生产主库
- **需重启**: 写入后提示用户重启 Claude Code

### Redis MCP
- **触发词**: "Redis 缓存"、"缓存调试"、"查 Redis"
- **配置**:
  ```json
  "redis": {
    "args": ["/c", "npx", "-y", "@modelcontextprotocol/server-redis", "redis://localhost:6379"],
    "command": "cmd", "type": "stdio"
  }
  ```

### Kubernetes MCP
- **触发词**: "K8s 部署"、"Pod 状态"、"容器调试"
- **配置**:
  ```json
  "kubernetes": {
    "args": ["/c", "npx", "-y", "mcp-server-kubernetes"],
    "command": "cmd", "type": "stdio"
  }
  ```

### Terraform MCP
- **触发词**: "Terraform"、"IaC"、"基础设施即代码"、"云资源管理"
- **配置**:
  ```json
  "terraform": {
    "args": ["/c", "npx", "-y", "mcp-server-terraform", "--workdir", "."],
    "command": "cmd", "type": "stdio"
  }
  ```
- **能力**: Terraform plan/apply/state 管理、HCL 语法辅助、Provider 配置
- **安全提醒**: 建议先 `plan` 审查再 `apply`，避免直接变更生产基础设施

### MCP 启用流程
1. 检测用户意图 → 匹配触发词
2. 询问连接信息 (如有需要)
3. 写入项目级 `.claude.json` 的 `mcpServers`
4. 提示用户重启 Claude Code
5. 验证 MCP 工具可用

---

## 插件市场 MCP 安装指南

> 以下 MCP 通过 Claude 官方插件市场 (`claude-plugins-official`) 安装。
> 安装后需在对应平台完成 OAuth 授权或 Token 配置。

### Slack
```shell
/plugin install slack@claude-plugins-official
```
- **能力**: 发送消息、搜索频道/消息、创建 Canvas、获取 Slack 上下文
- **授权**: 安装后 OAuth 授权 Slack Workspace
- **要求**: Claude Pro/Max/Team/Enterprise 计划

### Linear
```shell
/plugin install linear@claude-plugins-official
```
- **能力**: 搜索/创建 Issue、项目管理、Sprint 规划、评论
- **授权**: 安装后 OAuth 授权 Linear Workspace

### Atlassian (Jira + Confluence)
```shell
/plugin install atlassian@claude-plugins-official
```
- **能力**: Jira Issue 管理/Sprint/看板 + Confluence 文档搜索/创建
- **授权**: 安装后 OAuth 授权 Atlassian Cloud

### Supabase
```shell
/plugin install supabase@claude-plugins-official
```
- **能力**: PostgreSQL 查询、Auth 管理、Storage 操作、Realtime 订阅
- **授权**: 安装后输入 Supabase Project URL + Service Role Key

### Firebase
```shell
/plugin install firebase@claude-plugins-official
```
- **能力**: Firestore CRUD、Auth 管理、Cloud Functions、推送通知 (FCM)
- **授权**: 安装后配置 Firebase Project ID + Service Account

---

## 云托管 MCP (claude.ai deferred tools)

> 以下 MCP 由 Claude 平台云托管，通过 ToolSearch 自动发现，无需本地配置。
> 首次使用时通过 `/mcp` 完成 OAuth 授权即可。

| MCP | 能力 | 授权方式 |
|-----|------|---------|
| **Vercel** | 部署管理、构建日志、项目配置、域名管理 | OAuth (Vercel 账号) |
| **Cloudinary** | 图片/视频上传、变换、CDN 分发、资产管理 | OAuth (Cloudinary 账号) |
| **Scholar Gateway** | 学术论文语义搜索、引用分析 | 无需授权 |
| **GraphOS (Apollo)** | GraphQL 文档搜索、Schema 设计指引 | 无需授权 |

---

## 全局 MCP 凭证配置

### GitHub (HTTP Remote)
- **凭证**: `GITHUB_PERSONAL_ACCESS_TOKEN` 系统环境变量
- **获取**: GitHub Settings → Developer settings → Fine-grained PAT
- **权限**: repo, issues, pull_requests, actions

### Sentry (HTTP Remote + OAuth)
- **首次使用**: Claude Code 中输入 `/mcp` → 选择 sentry → Authenticate
- **自动缓存**: OAuth token 由 Claude Code 管理

### Figma (HTTP Remote + OAuth)
- **首次使用**: Claude Code 中输入 `/mcp` → 选择 figma → Allow Access
- **要求**: Figma 账号需有目标文件访问权限

### Notion (stdio)
- **凭证**: 替换 settings.json 中 `<ntn_YOUR_NOTION_TOKEN>`
- **获取**: notion.so/profile/integrations → New Integration → Copy Token
- **连接**: 在 Notion 中对目标页面 Share → 添加 Integration

### Gamma (stdio)
- **凭证**: 替换 settings.json 中 `<YOUR_GAMMA_API_KEY>`
- **获取**: gamma.app → Settings → API

### Canva (stdio)
- **无需凭证**: Dev MCP 仅查询 SDK 文档

---

## MCP 总量控制

| 类型 | 数量 | 上下文影响 |
|------|------|-----------|
| 本地常驻 (settings.json) | 8 | 始终加载 |
| 云托管 (deferred tools) | 9 | 按需懒加载，节省 95% 上下文 |
| 插件市场 | 5 | 按需加载 |
| 按需模板 | 3 | 仅项目级启用 |
| **总计** | **25** | 活跃工具 < 80 (推荐阈值) |

> **最佳实践**: 上下文窗口可能从 200K 缩减至 70K（工具过多时）。
> 保持活跃 MCP < 10、总工具 < 80。云托管和插件市场的懒加载机制确保不超限。

---

## MCP 精准激活关键词索引

> 以下关键词用于路由引擎自动匹配 MCP 服务。说出任意关键词即可激活对应 MCP 工具链。
> 更新日期: 2026-03-30

### 本地 MCP (22 个)

| # | MCP | 路由技能 | 中文触发词 | 英文特异性术语 |
|---|-----|---------|-----------|---------------|
| 1 | **orbination** | workflow-automation-expert | 列出窗口, 读屏幕文字, 点击按钮, 点击菜单, 自动滚动, 桌面截图, 扫描元素, 键盘快捷键, 鼠标拖拽 | OCR, UIAutomation, ocr_window, click_element, list_windows, auto_scroll |
| 2 | **windows-mcp** | workflow-automation-expert | 杀进程, 注册表, 剪贴板, 系统通知, 打开应用, 文件操作 | PowerShell, Registry, Process, Clipboard, Notification |
| 3 | **askui-vision** | workflow-automation-expert | 看到屏幕上, 找到那个按钮, 视觉识别, 视觉点击, 看截图点击 | vision_click, vision_locate, vision_get, vision_type |
| 4 | **mcp-com-server** | workflow-automation-expert | 操控Excel, 操控Word, 发邮件Outlook, COM对象, 写入单元格 | CreateObject, VBA, OLE, ActiveX, COM |
| 5 | **chrome-devtools** | browser-automation-expert | 调试页面, 执行JS, 抓网络请求, 性能分析, 内存快照, 控制台日志 | DevTools, CDP, evaluate_script |
| 6 | **playwright** | browser-automation-expert | 打开网页, 自动化测试, 填表单, 网页截图, 上传文件, E2E测试 | Playwright, browser_navigate, browser_click, browser_snapshot |
| 7 | **browserbase** | browser-automation-expert / browse | 云浏览器, 远程浏览器, 智能提取页面, AI操作网页 | Stagehand, Browserbase, stagehand_act, stagehand_extract |
| 8 | **firecrawl** | browser-automation-expert | 爬取网站, 抓取页面, 提取数据, 站点地图, 批量采集 | Firecrawl, scrape, crawl, sitemap |
| 9 | **github** | developer-expert | 创建PR, 提Issue, 搜索仓库, 创建分支, 合并PR, 代码审查 | GitHub, Pull Request, fork |
| 10 | **slack** | developer-expert | 发Slack消息, 查看频道, 回复线程, Slack历史 | Slack, slack_post, channel |
| 11 | **context7** | developer-expert | 查最新文档, 查API文档, 这个库怎么用, 最新版本用法 | context7, query-docs, resolve-library |
| 12 | **sequential-thinking** | developer-expert | 一步步分析, 逻辑推导, 分步推理, 深度思考 | chain-of-thought, sequential |
| 13 | **notebooklm** | developer-expert | 查笔记本, 问笔记, 搜索笔记, 创建笔记本 | NotebookLM, notebook |
| 14 | **cloudflare** | edge-computing-expert | Cloudflare文档, Workers迁移, Pages转Workers | Cloudflare, Workers, Pages |
| 15 | **deep-research** | (按需) | 深度调研, 全面研究, 多轮搜索, 自主调查 | deep-research |
| 16 | **mobile** | mobile-expert | 手机操作, 安装APK, 手机截图, 模拟器操作 | ADB, Android, iOS |
| 17 | **linear** | (按需) | Linear任务, 创建Issue, 任务看板 | Linear, sprint |
| 18 | **atlassian** | (按需) | Jira工单, Confluence文档, 查看看板 | Jira, Confluence, Atlassian |
| 19 | **supabase** | (按需) | 查数据库, 建表, 用户认证, 存储桶 | Supabase, PostgreSQL, Edge Function |
| 20 | **figma** | (按需) | 设计稿, 读取Figma, UI标注 | Figma, design token |
| 21 | **scrapling** | browser-automation-expert | Python爬虫, 抓取解析 | scrapling, BeautifulSoup |
| 22 | **pywinauto** | workflow-automation-expert | Python控制窗口, 自动化GUI, Win32控件 | pywinauto, win32gui |

### 云托管 MCP (8 个)

| # | MCP | 中文触发词 | 英文特异性术语 |
|---|-----|-----------|---------------|
| 23 | **sentry** | 错误追踪, 异常监控, 线上报错 | Sentry, error tracking |
| 24 | **notion** | 写Notion, 查Notion, Notion数据库 | Notion, page, database |
| 25 | **gamma** | 做PPT, 生成演示文稿, 做幻灯片 | Gamma, presentation |
| 26 | **canva** | 做海报, 做封面图, 社交媒体图 | Canva, template |
| 27 | **vercel** | 部署项目, Vercel部署, 查看部署状态 | Vercel, deploy, serverless |
| 28 | **cloudinary** | 图片处理, 压缩图片, 视频转码, 图床CDN | Cloudinary, transform |
| 29 | **scholar-gateway** | 搜论文, 学术搜索, 查引用, 文献检索 | Scholar, citation, paper |
| 30 | **graphos** | GraphQL网关, API联邦, Schema管理 | GraphOS, Apollo, federation |

### 按需模板 MCP (4 个)

| # | MCP | 中文触发词 | 英文特异性术语 |
|---|-----|-----------|---------------|
| 31 | **postgres** | 连数据库, 查表, 跑SQL, 数据库调试 | PostgreSQL, psql, SQL |
| 32 | **redis** | Redis缓存, 缓存调试, 查Redis | Redis, cache |
| 33 | **kubernetes** | K8s部署, Pod状态, 容器调试 | Kubernetes, K8s, kubectl |
| 34 | **terraform** | Terraform, IaC, 基础设施即代码, 云资源管理 | Terraform, HCL, Provider |