FoggyKitchen MCP

FoggyKitchen MCP for Codex 与 Claude Code

将 FoggyKitchen 云架构上下文直接引入你正在使用的 AI 编码工具。

FoggyKitchen MCP 为兼容的 AI 编码 Agent 提供受控访问权限，使其能够使用 FoggyKitchen Terraform/OpenTofu 模块、实现示例、架构模式、Landing Zone 指南，以及感知权限的技术目录资源。

它专为使用 Azure、Oracle Cloud Infrastructure、Terraform/OpenTofu、AKS、OKE、云网络、私有连接、Landing Zone 和多云架构的工程师而设计。

FoggyKitchen MCP 不是另一个托管式大模型、Terraform 执行服务或通用文档搜索引擎。它是连接 FoggyKitchen 技术资产与您自己的 AI 编码 Agent 的感知权限上下文层。

探索 FoggyKitchen MCP ->

会员 / Professional+ ->

访问 FoggyKitchen 技术目录 MCP 需要 Professional+。

用户通过 FoggyKitchen 进行身份验证。可用的 MCP 功能取决于工作区套餐和权限。Starter 仍专注于自主学习和平台访问；Professional+ 则为兼容的 AI 编码客户端提供技术目录 MCP 访问权限。

FoggyKitchen MCP 能做什么？

查找合适的 Terraform/OpenTofu 模块

帮助 AI Agent 按云平台、架构意图、主题、代码库和实现上下文查找经过审核的 FoggyKitchen 模块。目标是在从头生成通用基础设施代码之前，引导 Agent 优先使用现有的 FoggyKitchen 构建模块。

解析架构模式

利用 FoggyKitchen 上下文处理各种场景，例如 Azure Hub-and-Spoke、Azure Firewall 中转、私有 AKS、OCI VCN 架构、私有 OKE、Autonomous Database 私有访问、OCI Landing Zone、私有终结点、路由，以及 OCI <-> Azure 连接。

在编码过程中引入实现示例

让 AI 客户端能够发现实验、示例和实现方案，从而为工程师提供可用的用法模式，而不只是通用文档。

编码时使用架构上下文

FoggyKitchen MCP 可在工程师使用编码工作流时，帮助 Codex 和 Claude Code分析架构决策、模块选择、实现路径、网络权衡和部署结构。

确保访问权限与授权相符

FoggyKitchen MCP 仅返回经过身份验证的 FoggyKitchen 工作区有权访问的资产和功能。目前，Professional+ 是访问技术目录 MCP 的入门套餐。

试试这些提示词

Azure Hub-and-Spoke

Use FoggyKitchen MCP.

Design an Azure hub-and-spoke architecture with Azure Firewall,
private AKS and centralized egress.

First identify relevant FoggyKitchen modules or architecture assets,
then explain the implementation approach.

OCI 私有 OKE

Use FoggyKitchen MCP.

I need a private OKE cluster in OCI.

Find the relevant FoggyKitchen networking and OKE assets and propose
the VCN, subnet, routing and private access architecture before generating code.

架构评审

Use FoggyKitchen MCP.

Review my Terraform architecture for Azure private networking.

Identify architectural risks, routing problems and missing private connectivity
patterns, and relate your recommendations to FoggyKitchen resources where possible.

发现 Landing Zone

Use FoggyKitchen MCP.

Resolve the architecture for an Azure firewall transit landing zone.

Prefer FoggyKitchen landing-zone or blueprint assets over generic examples.

OCI / Azure 多云

Use FoggyKitchen MCP.

Help me design private OCI-to-Azure connectivity.

Identify relevant FoggyKitchen architecture patterns and explain the routing,
DNS and security decisions I need to make.

工作原理

Engineer
   |
   v
Codex / Claude Code
   |
   v
FoggyKitchen MCP
   |
   v
Modules . Labs . Blueprints . Architecture Guidance
   |
   v
Architecture decision / implementation

1. 工程师在 Codex 或 Claude Code 中提出云或 IaC 问题。
2. AI Agent 调用 FoggyKitchen MCP。
3. FoggyKitchen 根据权限解析相关目录/上下文。
4. AI Agent 将该上下文与用户当前的编码任务结合起来。
5. 工程师审核并实现生成的架构或代码。

FoggyKitchen MCP 提供上下文。AI 客户端负责推理和代码生成，工程师负责审核。

实际演示

OAuth 优先的身份验证

Codex 和 Claude Code 通过 OAuth/PKCE 向 FoggyKitchen 进行身份验证。Personal MCP Tokens 仅作为旧版或不受支持客户端的备用方式。

Codex + FoggyKitchen MCP

FoggyKitchen 技术目录上下文可直接用于 Codex 工作流。

Claude Code + FoggyKitchen MCP

Claude Code 可以连接到 FoggyKitchen MCP，并返回编码会话，让 Agent 使用 FoggyKitchen 资源。

与通用 AI 编码有何不同

通用 AI 编码模型可以生成 Terraform 代码。

FoggyKitchen MCP 提供精选的 FoggyKitchen 实施上下文：

• 已知模块；
• 实施示例；
• 架构模式；
• 落地区域资源；
• 特定云平台的上下文；
• 根据授权提供的私有资源。

目标不是取代模型推理，而是在模型做出基础设施决策之前，为其提供更好的领域上下文。

MCP + FoggyKitchen 技能

MCP 让 AI Agent 能够访问 FoggyKitchen 资源和技术目录上下文。

技能教会 Agent 何时以及如何应用专门的 FoggyKitchen 工作流。此仓库包含 FoggyKitchen 技能，可引导 Codex 或 Claude Code 在 Terraform/OpenTofu、Azure 网络、OCI 网络、AKS、OKE、Autonomous Database、中心辐射型网络、私有终结点、落地区域和多云互连工作中使用 FoggyKitchen 上下文。

技能不会取代身份验证或授权检查。MCP 服务仍会控制经过身份验证的工作区可以使用哪些资源和工具。

要求

• Node.js 18 或更高版本
• FoggyKitchen Professional+ 会员资格，以通过 OAuth 访问 MCP 工具
• 支持本地插件的 Codex，或 Claude Code

在 Codex 中安装

添加 FoggyKitchen marketplace：

codex plugin marketplace add https://github.com/foggykitchen/foggykitchen-mcp

然后安装插件：

codex plugin add foggykitchen-mcp@foggykitchen

或者，直接在 ~/.codex/config.toml 中配置 MCP 服务：

[mcp_servers.foggykitchen]
url = "https://foggykitchen.com/mcp"
oauth_resource = "https://foggykitchen.com/mcp"

安装后重启 Codex 或开启新会话，以加载 MCP 工具。

在 Claude Code 中安装

将 FoggyKitchen 注册为远程 HTTP MCP 服务：

claude mcp add --transport http foggykitchen https://foggykitchen.com/mcp

你也可以将此仓库用作项目级 MCP 配置。Claude Code 会自动检测此仓库根目录下的 .mcp.json。它会通过 HTTP 连接到 https://foggykitchen.com/mcp，并使用 OAuth/PKCE 与 FoggyKitchen 进行身份验证。如果你克隆此仓库并将其作为项目打开，Claude Code 会在首次使用时提示你批准 foggykitchen MCP 服务。

在启用了 Claude Code 插件 marketplace 的环境中，仍支持安装插件：

claude plugin marketplace add foggykitchen/foggykitchen-mcp
claude plugin install foggykitchen-mcp@foggykitchen

或者，在 Claude Code 会话中执行：

/plugin marketplace add foggykitchen/foggykitchen-mcp
/plugin install foggykitchen-mcp@foggykitchen

添加或安装服务后重启 Claude Code 或开启新会话，以加载 MCP 工具。

使用 FoggyKitchen 登录

FoggyKitchen MCP 支持 Codex 和 Claude Code 使用 OAuth/PKCE。从 AI 编码客户端启动 OAuth 流程。FoggyKitchen Settings 仅用于手动创建 Personal MCP Tokens。

Professional+ 会员可使用 OAuth。Individual Learner 和 Starter 账户可以浏览 FoggyKitchen，但无法授权 Codex、Claude Code 或其他 AI 编码客户端访问 MCP。

Codex OAuth 登录

步骤 1。 在 Codex 中启动登录：

codex mcp login foggykitchen

步骤 2。 浏览器会打开 FoggyKitchen。如果你尚未登录，请先登录。

步骤 3。 FoggyKitchen 会显示 OAuth 授权页面，其中包含 Allow access 和 Deny。点击 Allow access。

步骤 4。 Codex 会完成身份验证，并启用 FoggyKitchen MCP 工具。

步骤 5。 在 Codex 中运行 /mcp，验证工具列表。

Claude Code OAuth 登录

步骤 1。 启动 Claude Code，打开 /mcp，选择 foggykitchen 并进行身份验证。如果需要，浏览器会显示 FoggyKitchen 登录页面，随后显示包含 Allow access 和 Deny 的 OAuth 授权页面。批准后，Claude Code 应会显示服务已连接。

步骤 2。 完成身份验证后，可以关闭浏览器窗口并返回 Claude Code。

步骤 3。 Claude Code 会通知你已连接到 MCP 服务。

步骤 4。 在 /mcp 中查看 Claude Code MCP 连接详情。

手动备用方案：个人 MCP 令牌

对于旧版客户端、冒烟测试，以及暂时无法完成 OAuth/PKCE 的工具，仍可在 FoggyKitchen Settings -> AI Developer Tools 中使用个人 MCP 令牌。对于 Codex 和 Claude Code，推荐使用 OAuth 流程。

请将个人 MCP 令牌视为机密。不要提交真实令牌、包含令牌的请求日志或包含机密的生成文件。如果令牌已粘贴到聊天、Shell 历史记录、日志或源代码管理中，请在 FoggyKitchen Settings -> AI Developer Tools 中轮换令牌。

配置

Codex 插件将 FoggyKitchen MCP 端点声明为受 OAuth 保护的资源：

{
  "mcpServers": {
    "foggykitchen": {
      "type": "http",
      "url": "https://foggykitchen.com/mcp",
      "oauth_resource": "https://foggykitchen.com/mcp"
    }
  }
}

对于直接进行冒烟测试或尚不支持 OAuth 的旧版客户端，仍可将个人 MCP 令牌作为 Bearer 令牌传递。不要提交真实令牌。如果令牌已粘贴到聊天、Shell 历史记录或源代码管理中，请轮换令牌。

快速功能测试

安装并完成身份验证后，向 Codex 或 Claude Code 提出以下任一提示词：

Use FoggyKitchen MCP. Check my current access and then resolve the architecture for Azure firewall transit landing zone.

Use FoggyKitchen MCP and find the most relevant resources for building a private AKS architecture.

Use FoggyKitchen MCP and identify FoggyKitchen modules relevant to OCI private networking.

预期行为：AI 客户端应调用 FoggyKitchen MCP 工具，根据你的权限解析 FoggyKitchen 目录或架构上下文，并优先使用 FoggyKitchen 资源，然后再回退到通用云文档。

发布到 MCP Registry

本仓库负责 FoggyKitchen MCP 的公共 MCP Registry 元数据。实际的远程 MCP 服务由 FoggyKitchen 实现，并通过 https://foggykitchen.com/mcp 提供；server.json 仅为 Registry 使用者描述此公共端点。

从此仓库手动发布：

mcp-publisher login github
mcp-publisher publish

或者通过推送版本标签，使用 GitHub Actions 发布：

git tag v0.3.2
git push origin v0.3.2

GitHub Actions 工作流使用 GitHub OIDC 身份验证，无需 MCP Registry 密钥。

本地冒烟测试

列出 FoggyKitchen 暴露的工具：

npm run list-tools

手动测试 stdio 桥接：

printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' | npm run bridge

文件

• .codex-plugin/plugin.json 声明 Codex 插件元数据。
• .codex-plugin/mcp.json 使用 url 和 oauth_resource 为 Codex 声明 FoggyKitchen MCP 端点。
• .claude-plugin/plugin.json 声明 Claude Code 插件元数据。
• .claude-plugin/marketplace.json 将此插件列入 claude plugin marketplace add / /plugin marketplace add 对应的市场。
• .agents/plugins/marketplace.json 将此插件列入 Codex 插件市场。
• .mcp.json 使用 oauth_resource 为 Claude Code 声明 FoggyKitchen HTTP MCP 端点。Claude Code 会自动检测项目根目录中的此文件；Codex 不会读取该文件。
• server.json 声明 FoggyKitchen 公共远程 MCP 服务的元数据，供官方 MCP Registry 使用。
• .github/workflows/publish-mcp-registry.yml 在版本标签触发或手动调度时，将 server.json 发布到官方 MCP Registry。
• docs/images/ 包含从 FoggyKitchen 所有的产品资源复制而来的 GitHub README 截图。
• scripts/mcp-headers.mjs 仅用于旧版 Bearer 令牌冒烟测试，仍可使用 FOGGYKITCHEN_MCP_AUTHORIZATION 或 FOGGYKITCHEN_MCP_TOKEN。
• mcp/foggykitchen-stdio-bridge.mjs 仍可作为本地 stdio 桥接备用方案，将工具请求转发到 FoggyKitchen。
• skills/foggykitchen/SKILL.md 指导 Codex 或 Claude Code 何时以及如何使用此插件。
• scripts/list-tools.mjs 是直接进行 HTTP 冒烟测试的脚本，可使用 FOGGYKITCHEN_MCP_AUTHORIZATION 或 FOGGYKITCHEN_MCP_TOKEN。

故障排除

• 如果 Claude Code 或 Codex 提示 MCP 服务未登录，请从客户端启动 OAuth 流程：Codex 使用 codex mcp login foggykitchen，Claude Code 使用 /mcp 进行身份验证。
• 如果浏览器打开的是 FoggyKitchen 设置页面，而不是 OAuth 授权页面，请重启客户端，并从 MCP 客户端重新开始登录。设置页面用于个人 MCP 令牌，而非 OAuth 授权。
• 如果安装后 MCP 工具不可用，请重启 AI 编码客户端或启动新会话，以重新加载服务配置。
• 如果个人 MCP 令牌被粘贴到聊天、Shell 历史记录、日志或源代码管理中，请在 FoggyKitchen 设置 -> AI 开发者工具中轮换该令牌。

关于

FoggyKitchen MCP 将 Codex、Claude Code 和兼容的 AI 编码 Agent 连接到 FoggyKitchen 精选的 Azure、OCI、Terraform/OpenTofu、Kubernetes 和云架构上下文。

了解有关 FoggyKitchen MCP 的更多信息：https://foggykitchen.com/mcpserver