今天我們要來用 Postman 提供的 Mcp Generator 來將 自己的 api 轉成 Mcp server.

我們需要使用最新版的 Postman, 否則你可能看不到 Mcp server 這個選項.

流程

首先先在 Postman 新增一個 public workspace,

下載這兩份 json 檔, 並按照順序匯入, 這樣我們就有一個 postman 的 api 文件了：

(1) Hardware-Issue-Tracker.postman_collection.json
(2) Hardware-Issue-Tracker-Environment.postman_environment.json

接著 上方欄 API Network -> 選 MCP Generator

-> 輸入你的 workspace 名稱

Note: 如果是新的 public workspace 要等大概兩小時才能被找到（先哭

選取後他會請你勾選你想要生成的 api 有哪些, 幫我全勾:

點選生成後, 下載 zip 檔

解壓縮後, 用 cursor 打開解壓後的資料夾

接著執行 npm install 安裝依賴套件,

接著打開 README 跟著指示走 (目前只有 placeholder 不會真的幫你填好無腦 paste), 我們這邊亦同繼續講解:

複製以下json，並將 args 改成剛剛生成的 MCP Server 資料夾內 mcpServer.js 的絕對路徑:

{
  "mcpServers": {
    "my-issue-server: {
      "command": "node",
      "args": ["複製你的mcpServer.js的絕對路徑貼到這"]
    }
  }
}

點選 cursor 右上角的齒輪按鈕 -> Mcp Server -> 新增 Mcp Server:

把剛剛複製的 json 貼進來後回到 cursor setting tab:

有興趣的同學可以打開mcpServer.js

可以看到他生成的 code 是可以直接拿來做 STDIO 或是 Streamable Http 都沒問題的:

接著我們來實驗一下這個 Mcp server 是否能正常運作,

請他試著用這個新的 mcp server 查看所有 issue,

我玩的過程中有遇到錯誤但是 LLM 自動幫我除錯並且找尋可以調用的 tools 有哪些,

最後返回了我想要的結果:

不同 Mcp Server Generator 兩者比較

上一篇的 huggingface 自動工具 [05] 還在手動寫 MCP Server？公開 API 一鍵轉換＋自動 Deploy

• 自動 deploy 成 Streamable http 大家都可以使用
• 需要將 API 文件公開於網路上（例如：https://myapi.json）
• 不受限於特定 API 服務商

postman

• 適合原本就使用 Postman 紀錄 API 的團隊
• 目前僅能從 Postman 的 Public Workspace 生成（API 文件來源受限於 Postman）
• 可自行選擇要生成的 API endpoints

共通點

• 兩者皆能取得原始碼
• 兩者皆需要將 API 文件暴露在公開網路上

現況與未來

目前這兩個工具都只能針對「公開的 API 文件」生成 MCP Server code。

不過，Postman 官方已經宣布：未來將支援從 Private Workspace 轉換為 MCP Server code。

待功能釋出，我們就能將公司內部系統轉換成 MCP Server，而不必冒著將 API 資訊公開的風險。

想像一下：公司內部的 issue 通報系統也能安全地轉換成 MCP Server，之後你也能直接在 cursor 裡面發 issue 了, 不用在 copy and paste 跳來跳去了.

小挑戰: 用 Postman 生成 Notion Pages MCP Server

我們在 [02] 零基礎新手體驗：如何在 Cursor 玩 MCP Server（Notion 為例） 有用過現成的 Notion MCP Server, 這是別人寫好的, 請你現在用在 postman 公開的 Notion API 生成成 MCP Server, 請只選跟 pages 有關 api 們. 自己試試看吧~

Note: 記得設定 NOTION_S_API_WORKSPACE_API_KEY, 嘗試用 LLM 請他新增一個頁面說明這個 Notion MCP Server 有哪些方法可使用.

今天就先這樣拉！我們明天見