Building an MCP Server with TypeScript from Scratch

这篇新闻的核心亮点是：一位开发者手把手教你用TypeScript从零搭建一个真正可用的MCP服务器，而且直接解决了官方文档“照抄没用、深入看又太啰嗦”的尴尬。通俗来说，MCP（模型上下文协议）就像给AI大模型装上了“万能遥控器”，让AI能自己调用外部工具、读取文件、执行命令。这篇文章不仅教你怎么写代码，还特别提醒了一个致命坑：如果用标准输出（stdout）传数据，哪怕一行打印日志都会让整个通讯“死机”——必须用错误输出（stderr）才能正常工作。这个细节几乎每个初学者都会踩，作者直接把它放在了最前面。实际影响：对于普通用户，这项技术意味着未来你用的AI助手将不再只是“聊天机器”，而是能帮你订票、查数据库、写代码并自动运行的工具集。而开发者学会了这个MCP服务器搭建方法，就能为各类AI平台开发插件或服务，让AI真正变成你工作流中的自动化“员工”。整个过程不需要高深框架，但讲究细节，这篇文章正好填补了官方文档的空白。

The Model Context Protocol (MCP) has a fragmentation problem in its documentation: most examples are either too minimal to be useful, or they bury the key concepts under framework boilerplate. This article walks through building a real MCP server in TypeScript — one that implements all three primitives (Tools, Resources, Prompts) and runs over both stdio and HTTP transport. The code is production-shaped, not toy-shaped. By the end you'll understand not just what to write, but why each piece is the way it is. <h2> The One Thing You Must Know About stdio </h2> Before any code: if you use stdio transport, all logging must go to <code>stderr</code>. Not <code>console.log</code> — <code>console.error</code>. stdio transport uses <code>stdout</code> as the protocol channel for JSON-RPC frames. A single <code>console.log</code> corrupts the frame and causes host parsing failures. The SDK won't warn you. The host just silently breaks. <div class="highlight js-code-highlight"> <pre class="highlight typescript"><code>// ✅ correct console.error('Server started'); // ❌ corrupts the JSON-RPC channel console.log('Server started'); </code></pre> </div> This trips up almost everyone the first time. Now you know. <h2> Project Setup </h2> An MCP server runs as an independent process — it doesn't share a process with your existing web server. Create a dedicated package: <div class="highlight js-code-highlight"> <pre class="highlight json"><code>{ "name": "@ts-ai/mcp-server", "version": "1.0.0", "type": "module", "bin": { "ts-ai-mcp": "./dist/index.js" }, "scripts": { "dev": "tsx watch src/index.ts", "build": "tsc", "inspect": "npx @modelcontextprotocol/inspector node dist/index.js" }, "dependencies": { "@modelcontextprotocol/sdk": "^1.29.0", "zod": "^3.23.0"<span class="