🚀 MCP 协议快速入门指南（TypeScript 版）
这是一个使用 TypeScript 实现的 MCP 快速入门示例。它借助 stdio 传输协议实现了基本的 MCP 服务器，并能从 Hacker News 获取顶级故事。该实现无需构建步骤，可直接在 Node.js v23 上运行，且基于 MCP 官方文档 中的示例构建。
🚀 快速开始
安装依赖
以下代码片段需要使用 git、nvm 和 pnpm。
git clone git@github.com:cephalization/mcp-ts-quickstart.git
cd mcp-ts-quickstart
nvm install && nvm use
pnpm install
添加服务器到 Claude Desktop
克隆并安装依赖后，可以将此服务器添加到 Claude Desktop 中，配置文件类似如下：
{
"mcpServers": {
"hacker-news": {
"command": "/Users/tony/.nvm/versions/node/v23.6.0/bin/node",
"args": ["/Users/tony/repos/mcp/src/index.ts"]
}
}
}
有关如何使用 Claude Desktop 的详细信息，请参阅 MCP 官方文档。
🛠️ 开发
运行以下命令可以安装依赖，然后启动 MCP 服务器，并使用 MCP Inspector UI 作为客户端。
nvm install && nvm use
pnpm install
pnpm start
由于服务器是无构建步骤的，您可以在 inspector UI 中通过点击“重新启动”按钮来重启服务器。
🚧 扩展服务器
文件位置
- 服务器实现位于
src/index.ts文件中。 - 顶级故事工具实现位于
src/tools.ts文件中。
添加新工具
要添加新的工具，请复制顶级故事工具并进行修改。
导入注意事项
- 在导入本地源文件时，请确保使用
.ts扩展名，以便 Node 可以正确解析。 - 在导入类型时，请确保在前面加上
type关键字，以便 Node 运行时可以将其剥离。 - 在导入库时，请确保导入实际的文件扩展名，如果库不提供导出映射。
🔍 MCP Inspector
MCP Inspector 是一个用于与 MCP 服务器交互的 UI。运行后，它将在 http://localhost:6274 可用。