[!info] related notes

• 对象介绍: MCP
• 上层主题: AI MOC
• 编程实践: Coding Agent MOC

MCP MOC

知识总览

filters:
  and:
    - 'file.ext == "md"'
    - 'file.inFolder("z")'
    - 'this.file.links.contains(file)'
    - 'file.path != this.file.path'
formulas:
  knowledge: 'file.asLink(title)'
properties:
  formula.knowledge:
    displayName: 知识
  note.description:
    displayName: Description
  note.mastery:
    displayName: Mastery
views:
  - type: table
    name: 知识总览
    order:
      - formula.knowledge
      - note.description
      - note.mastery
    columnSize:
      formula.knowledge: 280
      note.description: 760
      note.mastery: 56

这张地图覆盖什么

这张地图组织 MCP 的协议心智模型、客户端接入、本地 Server 启动方式，以及“按任务领域选择工具”的索引。它不重复各工具的安装说明，也不替代 MCP 对协议本身的解释。

从这里开始

1. MCP：理解 Host、Client、Server 与 tools/resources/prompts 的分工。
2. 本地 MCP Server：理解 command --mcp 如何被 Host 拉起，以及 stdio 为什么不能混入日志。
3. MCP 客户端配置指南：按 Codex、Claude、VS Code、OpenCode 的真实格式接入。
4. MCP HTTP 授权与 REST API 鉴权的关系：区分工具调用协议、Bearer Token 与首次 OAuth 授权。
5. MCP 在 Agent Harness 中的配置架构：理解项目声明、权限、生命周期和工具预算如何收敛。
6. 依任务进入下方工具领域，不要一次加载所有 Server。

若目标是让 ChatGPT 安全访问本机服务，进入 openai-secure-mcp-tunnel 与 blogs/thought-forest-chatgpt-mcp-tunnel-debug。

协议、架构与配置

• MCP：协议对象与核心角色。
• 本地 MCP Server：stdio 本地服务的生命周期、JSON-RPC 与安全边界。
• MCP 客户端配置指南：本地 stdio / 远程 HTTP 的配置和验证。
• 项目级 MCP 配置指南：把项目能力需求提交到 Git，同时不提交密钥。
• MCP 在 Agent Harness 中的配置架构：MCP 如何进入 Harness 的 Tool Runtime 与控制面。
• function-calling：模型调用工具的机制。
• MCP vs Function Calling：区分模型调用表达层与能力接入协议层。
• mcp-gateway-architecture-evolution：从多个直连 Server 到统一网关的演进。
• Docker MCP Gateway：容器化 Server 的统一代理模式。
• Docker MCP Toolkit MOC：Docker 实践入口。
• OpenAI Secure MCP Tunnel：通过出站连接把本机或私网 MCP 暴露给授权的 ChatGPT 工作区。
• OpenAI API Tools、MCP 与托管工具：比较三类工具的控制面和信任边界。

远程 HTTP MCP 的授权与 OAuth

本组优先按“网络请求 → 用户委托 → 客户端标识 → 注册方式 → 授权生命周期”阅读，理解后才进入具体 SDK / Hosted Gateway 实现。

1. MCP HTTP 授权与 REST API 鉴权的关系：确认 MCP 仍使用 HTTP Bearer，分辨 PAT、OAuth 与本地 stdio。
2. OAuth 2.0 → 授权码 + PKCE：理解首次授权和常规业务请求的时序。
3. OAuth Client 标识、认证与用户身份的区别：澄清 client_id、用户登录、委托权限并非同一件事。
4. 预注册、CIMD 与 DCR：读懂客户端登记的三条路线。
5. CIMD、DCR：分别掌握机制与威胁边界。
6. OAuth 委托授权生命周期与即时撤销：理解 refresh、scope 缩减、撤销再授权与旧 Token 防复活。

ChatGPT 与本地知识库实践

• chatgpt-local-obsidian-maintenance-architecture：端到端架构与职责边界。
• connect-local-mcp-to-chatgpt-with-secure-tunnel：Tunnel 连接实施指南。
• two-stage-proposal-merge-security-boundary：提案、第二次批准与精确合并的安全不变量。
• blogs/thought-forest-chatgpt-mcp-tunnel-debug：完整实施复盘与运行手册。
• 用代理模式给官方 MCP Server 注入自定义工具：把官方 filesystem server 当子进程代理、注入 run_command 的代码配方（oracle3/oracle2 远端桥同源）。

按领域找 MCP 工具

代码理解、仓库与构建

• CodeGraph：符号、调用链与改动影响范围；适合日常代码导航。
• GitNexus：面向陌生仓库的预计算架构知识图谱。
• Repomix：把仓库筛选、打包成模型可读快照；不是调用关系图。
• Nx MCP：Nx workspace、project、target、affected 与任务依赖。
• mcp-filesystem：受限文件系统访问的代表 Server。

外部文档与知识

• Context7：检索当前、版本相关的库文档和示例。
• Mem0：为多个 Agent 提供可持久化的记忆后端。

浏览器、页面与测试

• chrome-devtools-mcp：浏览器 DevTools 自动化与调试能力。
• Browser DevTools MOC：浏览器调试工具的整体入口。
• puppeteer：浏览器自动化相关能力记录。

设计与前端实现

• v0 MCP：在 Agent 工作流中引入 v0 的 UI 设计与生成能力。
• shadcn/vue MOC：组件库与 MCP 入口。

API、数据与平台

• postman-governance-catalog-workspaces-and-mcp：将 API 资产治理与 MCP 接入结合的 Postman 案例。
• docker-mcp-toolkit：容器化 MCP 工具的安装与管理能力。

选型速记

问题	优先入口
当前项目的函数、调用链和影响范围	CodeGraph
当前框架/SDK 的官方最新用法	Context7
Nx 工程结构、target 与 affected	Nx MCP
浏览器页面诊断与自动化	chrome-devtools-mcp
多个容器化 Server 的集中管理	Docker MCP Gateway
为 Agent 连接 API 资产	Postman MCP

相邻地图

• AI MOC
• Coding Agent MOC
• Docker MCP Toolkit MOC
• OpenAI 产品 MOC