菜单
使用 Node/TypeScript SDK 构建 MCP (Model Context Protocol) 服务器 —— tools、resources、prompts、Zod 验证、stdio vs Streamable HTTP。需要最新 API 时查询 Context7 或官方 MCP 文档。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
何时使用需要为编程项目、monorepo 或多级目录创建/更新 AGENTS.md、CLAUDE.md 软链接、项目级 agent 操作手册、子目录局部规则、验证命令和 Coding Agent 上下文边界时使用。
分析代码库结构并生成中文 token-lean 架构文档。
用于构建或维护个人 LLM 驱动的知识库。触发词：将资料导入 wiki、查询 wiki 知识、检查 wiki 质量、'添加到 wiki'、'我了解什么关于'，或任何提到 'LLM wiki' 的场景。
当有书面实施计划要在单独会话中执行并带审查检查点时使用
用户明确要求隔离工作区、并行分支验证或临时试验时使用 - 创建隔离的 git worktree
开始开发编程相关对话时使用 - 建立如何查找和使用 skills，在做出任何响应前要求先检查适用的 skill
| name | dev-mcp-patterns |
| description | 使用 Node/TypeScript SDK 构建 MCP (Model Context Protocol) 服务器 —— tools、resources、prompts、Zod 验证、stdio vs Streamable HTTP。需要最新 API 时查询 Context7 或官方 MCP 文档。 |
Model Context Protocol (MCP) 让 AI 助手能够调用工具、读取资源和使用来自你服务器的 prompts。使用此 skill 构建或维护 MCP 服务器。SDK API 会演进；通过 Context7 (query-docs for "MCP") 或官方 MCP 文档检查当前方法名和签名。
使用场景：实现新的 MCP 服务器、添加工具或资源、选择 stdio vs HTTP、升级 SDK、调试 MCP 注册和传输问题。
registerTool() 或 tool() 注册，取决于 SDK 版本。registerResource() 或 resource() 注册。处理器通常接收 uri 参数。registerPrompt() 或等效方法注册。Node/TypeScript SDK 可能暴露 tool() / resource() 或 registerTool() / registerResource()；官方 SDK 随时间变化。始终根据当前 MCP 文档 或 Context7 验证 @modelcontextprotocol/sdk 签名，避免复制粘贴错误。
对于本地客户端，创建 stdio transport 并传递给你服务器的 connect 方法。确切 API 因 SDK 版本而异（例如 constructor vs factory）。查询官方 MCP 文档或 Context7 "MCP stdio server" 获取当前模式。
保持服务器逻辑（tools + resources）独立于 transport，这样你可以在 entrypoint 中插入 stdio 或 HTTP。
对于 Cursor、云端或其他远程客户端，使用 Streamable HTTP（根据当前 spec 的单个 MCP HTTP 端点）。仅当需要向后兼容时才支持遗留 HTTP/SSE。
npm install @modelcontextprotocol/sdk zod
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";
const server = new McpServer({ name: "my-server", version: "1.0.0" });
使用你的 SDK 版本提供的 API 注册工具和资源：某些版本使用 server.tool(name, description, schema, handler)（位置参数），其他使用 server.tool({ name, description, inputSchema }, handler) 或 registerTool()。Resources 同理 —— 当 API 提供时在处理器中包含 uri。查询官方 MCP 文档或 Context7 获取当前 @modelcontextprotocol/sdk 签名，避免复制粘贴错误。
使用 Zod（或 SDK 首选的 schema 格式）进行输入验证。
@modelcontextprotocol/sdk (npm)。使用 Context7 库名 "MCP" 获取当前注册和传输模式。modelcontextprotocol/go-sdk)。