[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"pack-detail-mcp-server-dev-starter-zh":3,"seo:pack:mcp-server-dev-starter:zh":100},{"code":4,"message":5,"data":6},200,"操作成功",{"pack":7},{"slug":8,"icon":9,"tone":10,"status":11,"status_label":12,"title":13,"description":14,"items":15,"install_cmd":99},"mcp-server-dev-starter","🔌","#8B5CF6","new","本周新建","MCP Server 开发者起步包","给第一次写 MCP server 的开发者用的十件套：选 SDK（TypeScript \u002F Python \u002F Go），用框架脚手架起项目，在 MCP Inspector 里调试，最后提交到 Smithery 注册中心和 awesome-mcp-servers 索引 — 全部按推荐安装顺序排好。",[16,28,35,44,51,58,65,75,85,92],{"id":17,"uuid":18,"slug":19,"title":20,"description":21,"author_name":22,"view_count":23,"vote_count":24,"lang_type":25,"type":26,"type_label":27},796,"302d7709-9502-4431-9386-eeb966d200d3","mcp-inspector-debug-test-mcp-servers-302d7709","MCP Inspector — Debug and Test MCP Servers","Official debugging tool for MCP servers. MCP Inspector provides a web UI to connect, test tools, inspect messages, and validate responses from any MCP server interactively.","MCP Hub",131,0,"en","mcp","MCP",{"id":29,"uuid":30,"slug":31,"title":32,"description":33,"author_name":22,"view_count":34,"vote_count":24,"lang_type":25,"type":26,"type_label":27},3143,"152110ec-9a13-4942-b142-0ac3eff2a974","microsoft-mcp-official-model-context-protocol-sdk","Microsoft MCP — Official Model Context Protocol SDK","Microsoft MCP provides official Model Context Protocol building blocks and samples so teams wire reliable tools into agents without ad‑hoc contracts.",79,{"id":36,"uuid":37,"slug":38,"title":39,"description":40,"author_name":22,"view_count":41,"vote_count":24,"lang_type":25,"type":42,"type_label":43},3094,"06ee3ea4-e573-4f6c-8cc4-cef1c1cc8de0","mcp-python-sdk-build-mcp-servers-clients","MCP Python SDK — Build MCP Servers & Clients","Build MCP servers and clients in Python with FastMCP, plus a CLI for dev and install flows; supports stdio, SSE, and Streamable HTTP transports.",60,"script","Script",{"id":45,"uuid":46,"slug":47,"title":48,"description":49,"author_name":22,"view_count":50,"vote_count":24,"lang_type":25,"type":26,"type_label":27},3946,"4c9dd8ef-7adc-5835-bb5a-2a2ccb2fda88","fastmcp-python-framework-for-mcp-servers","FastMCP — Python Framework for MCP Servers","FastMCP is a Python framework for building MCP servers\u002Fclients with generated schemas and lifecycle handling. Verified 25154★; pushed 2026-05-13.",86,{"id":52,"uuid":53,"slug":54,"title":55,"description":56,"author_name":22,"view_count":57,"vote_count":24,"lang_type":25,"type":26,"type_label":27},3686,"8dd07efd-d9a7-5258-967a-43f367ba93f7","fastmcp-typescript-framework-for-mcp-servers","FastMCP — TypeScript Framework for MCP Servers","FastMCP is a TypeScript framework on top of the official MCP SDK; verified 3,112★ and includes HTTP streaming, stateless mode, and a CLI for dev+inspect.",76,{"id":59,"uuid":60,"slug":61,"title":62,"description":63,"author_name":22,"view_count":64,"vote_count":24,"lang_type":25,"type":26,"type_label":27},3186,"cad7f465-8f0f-4455-b75b-704d94077c15","mcp-go-build-mcp-servers-in-go","mcp-go — Build MCP Servers in Go","mcp-go is a Go SDK for building MCP servers (tools, resources, prompts) and serving them over stdio transports, so agents can call your Go code as tools.",71,{"id":66,"uuid":67,"slug":68,"title":69,"description":70,"author_name":71,"view_count":72,"vote_count":24,"lang_type":25,"type":73,"type_label":74},664,"8cf17e75-0c30-4c57-971d-34d7284e4049","build-your-own-mcp-server-step-step-guide-8cf17e75","Build Your Own MCP Server — Step-by-Step Guide","Complete guide to building a custom MCP server from scratch. Covers the protocol, TypeScript and Python SDKs, tool definition, resource management, testing, and deployment patterns.","Prompt Lab",163,"prompt","Prompt",{"id":76,"uuid":77,"slug":78,"title":79,"description":80,"author_name":81,"view_count":82,"vote_count":24,"lang_type":25,"type":83,"type_label":84},64,"04ab7e67-695d-4138-b53a-6ecae4f695ea","claude-official-skill-mcp-builder-04ab7e67","Claude Official Skill: mcp-builder","Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP serve...","Anthropic",123,"skill","Skill",{"id":86,"uuid":87,"slug":88,"title":89,"description":90,"author_name":22,"view_count":91,"vote_count":24,"lang_type":25,"type":26,"type_label":27},810,"5ca696fe-0d4f-4b2e-94f7-652f9d3a0da0","smithery-mcp-server-registry-installer-5ca696fe","Smithery — MCP Server Registry and Installer","Discover, install, and manage MCP servers from a curated registry. Smithery provides one-command setup for 200+ MCP servers with Claude Code and Cursor integration.",241,{"id":93,"uuid":94,"slug":95,"title":96,"description":97,"author_name":22,"view_count":98,"vote_count":24,"lang_type":25,"type":26,"type_label":27},3062,"cd5e75f3-8aa3-41fc-9a7e-be6394ad67af","awesome-mcp-servers-mcp-directory-index","awesome-mcp-servers — MCP Directory & Index","awesome-mcp-servers is a curated index of MCP servers, clients, and tutorials. Use it to pick a server, then add it to your MCP config and verify.",70,"tokrepo install pack\u002Fmcp-server-dev-starter",{"pageType":101,"pageKey":8,"locale":102,"title":103,"metaDescription":104,"h1":105,"tldr":106,"bodyMarkdown":107,"faq":108,"schema":124,"internalLinks":130,"citations":143,"wordCount":156,"generatedAt":157},"pack","zh","MCP Server 开发者起步包 — 从 SDK 到注册中心一次走完","MCP Inspector \u002F Microsoft TS SDK \u002F Python SDK \u002F FastMCP \u002F mcp-go \u002F Smithery \u002F awesome-mcp-servers — 给第一次写 Model Context Protocol server 的开发者用的生产侧起步包。SDK → 脚手架 → 调试 → 注册。","MCP Server 开发者起步包 — 从 SDK 到 Registry","十个按推荐顺序排好的工具，给的是\"写 MCP server\"的人，不是\"用 MCP server\"的人。选一门语言 SDK（TS \u002F Python \u002F Go），用框架脚手架起项目，在 MCP Inspector 里实时调试，最后提交到 Smithery 和 awesome-mcp-servers 让别人的 agent 能发现你。和消费侧的 MCP Server Stack 互为姊妹。","## 这个 pack 写给谁\n\n你在 Claude Code \u002F Cursor \u002F Codex CLI 里用 MCP server 已经一阵子了。现在你想**自己写一个** — 把内部 API、私有 CRM、自定义工具封成 MCP server，让所有支持 MCP 的 agent 都能调用。这是生产侧的起步包；如果你只想装现成的 server，看姊妹包 [MCP Server Stack](\u002Fzh\u002Fpacks\u002Fmcp-server-stack)。\n\n这十个工具覆盖完整闭环：选一门你已经在写的语言的 SDK，用更高层的框架脚手架起项目跳过样板代码，开着 MCP Inspector 实时调试，最后发布到 registry 让别人的 agent 能自动发现和安装。\n\n## 推荐安装顺序\n\n1. **MCP Inspector** — **第一个装**。MCP server 的官方 Web 调试 UI，可以连任何 server（stdio 或 HTTP）、列出 tool、发测试调用、看原始 JSON-RPC 报文。整个开发过程都开着这个标签页。不用 Inspector 调 MCP server 等于不用 DevTools 写网页。\n2. **Microsoft MCP — 官方 TypeScript SDK** — Node 这边的官方 SDK。定义了 `Server` 类、传输层（stdio \u002F HTTP）、带类型的 `RequestHandler`。想要完整控制权或者写参考样例就用这个。\n3. **MCP Python SDK** — Python 官方 SDK。形状和 TS 那个一致：`Server`、`stdio_server`、request handler。如果你的工具本体已经在用 Python 生态（数据 \u002F ML \u002F 爬虫），选 Python。\n4. **FastMCP — Python 框架** — MCP 界的 Flask（相对 Werkzeug）。装饰器式，样板代码大幅减少。`@mcp.tool()` 套在普通函数上就是个 server。90% 的 Python MCP server 用这个；只有需要细粒度传输层控制才往下掉到裸 SDK。\n5. **FastMCP — TypeScript 框架** — Node 这边同理念。`server.addTool({ name, parameters, execute })` 就完事。需要时和官方 TS SDK 混着用。\n6. **mcp-go — Build MCP Servers in Go** — Go SDK。延迟敏感或者要单二进制部署就选它（serverless 冷启动、嵌入 CLI、Docker scratch image）。\n7. **Build Your Own MCP Server — Step-by-Step Guide** — 第一次提交前先读的教程。讲 JSON-RPC 帧格式、tool 发现、错误信封、三种传输层。省半天读 spec 的时间。\n8. **Claude 官方 Skill: mcp-builder** — Anthropic 官方的 Claude skill，专门用来脚手架 MCP server。插到 Claude Code 里，描述你要的 tool，它会写出 SDK 样板（manifest、request handler、类型存根）。第一个 server 用起来很爽；写到第三个会发现自己想绕过它。\n9. **Smithery — MCP Server Registry & Installer** — 事实标准的 registry。发布到这里之后你的 server 就能 `npx smithery install your-server` 装，和几百个其他 server 一起列出。必看。\n10. **awesome-mcp-servers — MCP 目录索引** — GitHub 上人工维护的精选索引。server 稳定之后 PR 进去。受众和 Smithery 不一样（开发者在 GitHub 上浏览 vs agent 自动发现），两边都做。\n\n## 它们怎么协同\n\n```\n选 SDK：     Microsoft TS  ─┐\n             MCP Python    ──┼─▶  框架脚手架\n             mcp-go        ─┘     │\n                                  ├─ FastMCP Python\n                                  ├─ FastMCP TypeScript\n                                  └─ Claude mcp-builder skill\n                                          │\n                                          ▼\n                                  MCP Inspector\n                                  (实时调试 + 测试调用)\n                                          │\n                                          ▼\n                                   发布\n                                  ├─ Smithery registry\n                                  └─ awesome-mcp-servers PR\n```\n\n**SDK → 框架 → Inspector → registry** 四步闭环就是全部工作。多数翻车（agent 找不到你的 tool \u002F tool 调用挂死 \u002F schema 校验失败）都来自跳过 Inspector。**别跳过 Inspector**。\n\n## 你会遇到的取舍\n\n- **裸 SDK vs FastMCP** — 裸 SDK = hello-world 80 行代码、传输层和中间件完全自己控制。FastMCP = 12 行、装饰器式、有主见。从 FastMCP 起步，只有撞墙才掉到裸 SDK（自定义鉴权、自创非 stdio 传输层）。\n- **TypeScript vs Python vs Go** — TS 参考样例最多，原生支持 MCP 的 agent host 生态也最大。如果你的工具本体已经是 Python（pandas \u002F sklearn \u002F scrapy）选 Python。Go 适合单二进制部署和紧延迟。\n- **Smithery vs awesome-mcp-servers** — Smithery 机器可读（agent 自动安装），awesome-mcp-servers 人类可读（开发者在 GitHub 上翻）。漏斗不同 — 两边都提交。\n- **mcp-builder skill vs 自己手写** — Skill 适合第一个 server（生成正确的样板）。它生成的模式到第三个 server 你就想自己改了，预期会被你淘汰。\n\n## 常见踩坑\n\n- **stdio 传输层的 buffer 问题** — 永远别往 stdout 写日志。日志走 stderr，stdout 给 JSON-RPC 帧用。混着写会静默破坏每一条消息。\n- **Tool schema 漂移** — manifest 里 tool 的输入 schema 必须和 handler 实际期望的一致。MCP Inspector 会立刻暴露不匹配；不用 Inspector 你会花几小时纳闷为啥 agent 传 `query` 而 handler 读 `q`。\n- **长时间 tool 不发进度** — MCP 支持进度通知。如果你的 tool 超过 5 秒，要发进度，否则 host 会以为挂死直接超时。\n- **shutdown 时忘了清理** — 持资源的 handler（DB 连接、文件锁）需要 `on_shutdown` 清理。Inspector 抓不到，生产环境才会暴露。\n- **server 还没稳定就提交 Smithery** — 版本抖动会破坏每个 pin 你 server 的 agent 的安装。先打真正的 `v1.0.0` tag，再发布。",[109,112,115,118,121],{"q":110,"a":111},"TypeScript \u002F Python \u002F Go 必须一开始就选定吗？","选你工具本体已经在用的语言。MCP server 包了一个 Python 数据 pipeline 就用 Python 写；包了一个 Node API 客户端就用 TS。MCP 协议本身和语言无关 — agent 不知道也不在乎你 server 是什么语言写的，只关心你暴露的 tool 和 schema。别因为 TS 样例多就硬切语言。",{"q":113,"a":114},"FastMCP 还是裸的官方 SDK — 从哪个起步？","如果没有特殊理由，从 FastMCP 起步。官方裸 SDK 给你完整控制权，但一个 hello-world server 大约 80 行样板。FastMCP（Python 或 TS）用装饰器包一层，约 12 行就有一个能跑的 tool。真的需要定制（自定义鉴权 \u002F 奇特传输层 \u002F 深度中间件）随时可以掉回裸 SDK，逃生通道一直在。过早用裸 SDK 是第一次写 MCP server 永远发不出去的头号原因。",{"q":116,"a":117},"为啥代码都没开始写就把 MCP Inspector 列第一？","因为你第一个 handler 编译过的那一刻，你就想给它发个 tool 调用看原始 JSON-RPC 报文。Inspector 是唯一好用的交互方式。第一个装意味着你脚手架起来的 server 启动时，Inspector 已经在 localhost 上等着 — 省掉后面切换上下文。把它当成 DevTools，写网页前先装。",{"q":119,"a":120},"Smithery 和 awesome-mcp-servers — 两个都提交还是选一个？","两个都做。漏斗不同：Smithery 机器可读（agent 查 registry 自动装你的 server）；awesome-mcp-servers 人类可读（开发者在 GitHub README 里翻找要手动加的 tool）。只发 Smithery 不 PR awesome-mcp-servers 会切断每个还没上 Smithery 的开发者 — 2026 年这部分人还是大多数。",{"q":122,"a":123},"用这个 pack 多久能跑出第一个能用的 server？","对熟悉 TS 或 Python 的开发者来说大约两个晚上。第一晚：装 Inspector、用 FastMCP 脚手架、跑通端到端 hello-world tool 调用。第二晚：接你的真实 tool 本体、写 manifest、在 Inspector 里调 schema 不匹配、打包发 Smithery。如果愿意让 Claude 自己写脚手架，mcp-builder 这个 skill 能把第一晚压缩到大约一小时。",{"@context":125,"@type":126,"name":13,"description":127,"numberOfItems":128,"inLanguage":129},"https:\u002F\u002Fschema.org","ItemList","给第一次写 Model Context Protocol server 的开发者用的十件套 — SDK、框架、调试器、registry。",10,"zh-CN",[131,135,139],{"url":132,"anchor":133,"reason":134},"\u002Fzh\u002Fpacks\u002Fmcp-server-stack","MCP Server Stack 包","消费侧姊妹包：这个 pack 把 server 写出来之后，每个人都装的那些 MCP server",{"url":136,"anchor":137,"reason":138},"\u002Fzh\u002Fai-tools-for\u002Fmcp","TokRepo 全部 MCP 工具","在精选十件之外浏览更广的 MCP 目录",{"url":140,"anchor":141,"reason":142},"\u002Fzh\u002Ftopics","浏览其他主题 pack","相邻主题：Agent 框架、浏览器自动化、SDK 横评",[144,148,152],{"claim":145,"source_name":146,"source_url":147},"Model Context Protocol 规范与 SDK 参考","modelcontextprotocol.io","https:\u002F\u002Fmodelcontextprotocol.io",{"claim":149,"source_name":150,"source_url":151},"MCP Inspector 官方调试工具","MCP Inspector GitHub","https:\u002F\u002Fgithub.com\u002Fmodelcontextprotocol\u002Finspector",{"claim":153,"source_name":154,"source_url":155},"Smithery MCP server registry 和安装器","Smithery","https:\u002F\u002Fsmithery.ai",895,"2026-05-22T10:00:00Z"]