create-mcp-tool

用 Codex 给 ChatGPT 应用模板添加文本型 MCP 工具

Codex 安装步骤

运行 git clone https://github.com/pomerium/chatgpt-app-typescript-template.git。进入克隆目录并运行 git checkout --detach 444f3cfbcc0f2cc405a01d9dc4ab2215f6e1650c。
原仓库已将 .agents/skills/create-mcp-tool/SKILL.md 放在项目技能目录。按固定版本 README 的方法准备模板依赖。
从仓库根目录打开 Codex，用 /skills 或 $create-mcp-tool 选择技能。添加样例工具后，在项目目录运行 npm run test:server。

中文摘要

在 Pomerium 的 TypeScript 应用模板中添加一个 MCP 工具。技能说明把 Zod 输入放在哪里、在何处为会话注册工具，以及怎样验证响应和参数错误。

SKILL.md 中文导读

可复现示例

在固定版本的模板中添加只读术语表工具。数据写在内存里，包含「SSE」与「Markdown」。用关键词 SSE 和上限 1 检查返回值，再尝试输入上限 0。

工作步骤

把输入约束定义在 server/src/types.ts。
在 createMcpServer() 中注册工具并验证参数。
为正常和失败路径编写服务端测试。

验收方法

正常调用仅返回 SSE 条目，参数错误走验证分支。服务端测试同时覆盖有效输入和下界错误。

GitHub 原文 · 更新日期 2026-11-11

适用环境

需要 Codex 和所引版本的 Pomerium 模板。该提交的 package.json 要求 Node.js 24 或更高，示例使用本地数据。

常见问题

新增 MCP 工具必须写一个小组件吗？

模板支持只返回文本的工具。需要界面时再使用模板的 widget 约定，并保留对纯文本客户端有用的响应。