MCP server 教學：自己寫一個要多久？我從空資料夾實測一次

先把話說清楚：這篇 MCP server 教學，不是要你去學寫程式。

你每天打開 AI 的對話框，第一個動作通常是「貼」。貼昨天的報表、貼老闆那封信、貼你記在備忘錄裡的待辦。它要先看到，才幫得上忙。

麻煩的是關掉視窗它就忘光，明天你得再貼一次。

有一個東西可以讓 AI 自己伸手去拿，不用你貼。 它叫 MCP，官方文件上寫著 Claude 跟 ChatGPT 都支援。

我找了幾份 MCP server 教學來看，全是寫給工程師的，所以我乾脆自己從一個空資料夾開始跑一次。能動的那個檔案，最後是 19 行。

MCP 是什麼？先把它想成 AI 的萬用轉接頭

官方文件第一段就給了比喻：MCP 就是 AI 應用的 USB-C 孔。

你家那堆線材以前每個牌子一種頭，換一台裝置就要翻抽屜找線。後來大家講好都用同一種孔，一條線通吃。

AI 現在正好走到同一步。一邊是各種對話框，一邊是你的行事曆、你的檔案、你公司的資料，中間需要一個講好的接頭。

那個講好的規格就叫 MCP。而「MCP server」是插在你資料那一端的頭，負責把你的東西遞出去；我這次做的是最單純的一種，就是一個跑在自己電腦裡的小程式。

名字聽起來很嚇人，但別被騙了——它可以只是一個檔案。

那這個接頭能遞出什麼？官方文件把它分成三種。

第一種是「資料」：像是檔案內容、一份名單，AI 讀得到但不會動它。第二種是「工具」：你授權之後，AI 可以真的去執行的動作，例如寫一行字進檔案、送出一筆查詢。

第三種是「範本」：事先寫好的問法，你點一下就套用，不用每次重打。

我這次做的是第二種，因為它最有感——AI 不只是看到，而是真的動手。

每一份 MCP server 教學都從這裡開始：你只寫其中一小段

一個接頭要做的事其實不少：自我介紹、報上版本、列出「我會做哪些事」、收指令、回結果。

好消息是這些髒活官方套件全包了。你只寫最後那一小段：這個工具叫什麼名字、要幾個資料、拿到之後做什麼。

官方的說法是，套件會直接讀你寫的標註跟那段說明文字，自動生出工具的定義。

換句話說，你替 AI 寫的說明書，跟你替新同事寫的交接備註，長得幾乎一樣。

那到底要多久？我從一個空資料夾實測

我把目標縮到最小：做一個工具，讓 AI 幫我把一句話寫進電腦裡的記事檔。

實際長這樣：

from mcp.server import MCPServer

mcp = MCPServer("my-notes")


@mcp.tool()
def add_note(text: str) -> str:
    """Append a note to my notes file.

    Args:
        text: The note content
    """
    with open("notes.txt", "a", encoding="utf-8") as f:
        f.write(text + "\n")
    return "Saved: " + text


if __name__ == "__main__":
    mcp.run(transport="stdio")

你不用看懂這段，看它的長度就好。

中間那幾行英文說明就是寫給 AI 看的說明書，它讀完才知道這個工具什麼時候該拿出來用。真正做事的只有中間那兩行：把你那句話寫進檔案。

我沒有真的接上任何一個對話框，是自己照規格送了一次呼叫進去。工具真的執行了，檔案真的多一行。

誠實說：卡住的通常不是打字速度

看到這裡你可能想：19 行而已，那我也可以吧？

先看官方教學 Python 版自己寫的先決條件——它假設你已經熟悉這個語言，也用過 AI 模型。 這句話很老實，也是大部分人真正的門檻。

19 行是「知道要寫什麼」之後的 19 行。不知道的時候，卡住的是取名、是路徑、是它明明沒報錯卻什麼都沒發生。

順帶一提，「把打字這段交給 AI」這條路我之前示範過一次：一段話讓 AI 自己把爬蟲裝好。路數是一樣的。

規格才剛換過版，這對你的意義是什麼

這個領域現在的變動速度，比你想像的快。

官方規格的版本編號本身就是日期。最新一版是 2026-07-28，上一版是 2025-11-25，中間隔了八個多月，而新版把不少東西整個拿掉重做。

有意思的是，我今天裝到的官方套件是 2.0.0，它跟我的測試程式打招呼時，報的版本還是上一版。

還有更直接的：官方文件頁面教你載入的東西，跟官方放在 GitHub 上的完整範例載入的，已經不是同一個。 我照範例那個寫法試，在最新版套件裡直接找不到。

所以你現在要動手的話，我的建議是：照官方文件頁面走，不要照舊範例抄。

那你到底要不要自己寫一個？

想先感受一下「接上去」是什麼樣子，我之前寫過怎麼把 AI 接進看盤軟體，那篇裝的就是別人做好的現成品：把 Claude 接進 TradingView。

如果你更早的問題是「AI 幫我寫東西老是衝太快、還自稱做完了」，那先看這篇比較實際。

最後說兩句

回到標題那個問題：自己寫一個要多久？

能動的版本，我這次是 19 行加一次 3 秒的安裝。但這個數字沒有回答真正的問題。

真正的問題是：你手上有什麼東西，值得讓 AI 自己伸手去拿？ 想不出來的話，19 行寫再快也沒用；想得出來的話，你會發現這件事比你以為的近很多。

這種東西用看的比用讀的快。想看手怎麼動，酷可實驗室的頻道在這裡：YouTube——文章負責讓你想清楚要不要做，影片負責讓你看到過程。

---

測試環境：macOS，官方 Python 套件 2.0.0，2026 年 7 月 29 日實跑。本文的數字都是我在自己電腦上跑出來的：安裝時間、檔案行數、套件版本會因為你的環境而不同。規格與範例出處是官方文件 modelcontextprotocol.io 與官方放在 GitHub 上的範例，兩邊都可能隨時更新，動手前請以當下的官方頁面為準。

延伸閱讀：

• 我用 6 個月後留下的 Claude 設定拆解
• 用 AI 建立無人公司：多個 AI 互相協作的實戰
• 副業點子壓力測試：先確認這件事值不值得做
• 用 7 個問題挖出你早就有的商業點子