🚀 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 可用。