MCP Ts Quickstart

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