iT邦幫忙

2025 iThome 鐵人賽

DAY 22
0

前言

今天我們來看看另一個很實用的 MCP Server —— HackMD MCP Server
它是專門為 HackMD 筆記平台 打造的 MCP Server,讓 AI Agent(像 Claude、Cursor 等)可以透過 MCP 標準協議,幫你管理筆記、處理團隊協作,甚至自動化生成文件!
話不多說,正文開始φ(゜▽゜*)♪


HackMD MCP Server 功能總覽

以下整理了目前官方支援的工具(Tool),搭配參數與能做到的事情:

工具/方法 功能說明 參數 & 回傳內容
getUserInfo 取得使用者個人資訊 無 → 回傳暱稱、郵件、ID等
listNotes 取得使用者所有筆記清單(可加篩選/分頁) limit, offset, query → 筆記列表(ID、標題、狀態等)
createNote 新增筆記(支援 Markdown/JSON/YAML) 標題、內容、tags、狀態 → 新筆記 ID
readNote 查詢指定 ID 的筆記內容 noteId → 筆記內容、最後修改、作者等
updateNote 修改指定筆記內容 noteId, 新內容、tags → 更新結果
deleteNote 刪除指定筆記 noteId → 刪除結果
getReadHistory 取得筆記瀏覽紀錄 limit, offset → 最近查看的筆記列表
listTeamNotes 取得所屬團隊的所有筆記清單 teamId, limit, offset → 團隊筆記清單

使用情境(AI Agent 能幫你做什麼)

hackmd-mcp 不只是把 HackMD 功能「API 化」,它讓 Agent 能夠:

  • 知識管理:自動建立、分類、整理筆記,打造專屬知識庫。
  • 團隊協作:快速搜尋、分享、更新團隊筆記,提升工作效率。
  • 內容生成:AI 自動撰寫會議摘要、企劃大綱、文件初稿。
  • 筆記安全管理:透過 MCP 控管 API Token,確保敏感資訊安全。
  • 跨平台整合:支援 VSCode、Claude Desktop、Cursor 等工具,讓 AI 能直接操作 HackMD。

事前準備

設定建立API Token,如何取得請見官方說明
https://ithelp.ithome.com.tw/upload/images/20251006/20168454fjCopyZbAN.png

  • 建立好 API Token 務必妥善保存,關閉本視窗後就無法再看到這個 token 的明碼。
  • 免費版方案每月最多 2000 次呼叫;每五分鐘最多 100 次呼叫。

結尾廢話

到這裡,你應該對 hackmd-mcp 有初步概念了吧~
它其實就是一個讓 AI 變身「HackMD 筆記助理」的橋樑 (๑•̀ㅂ•́)و✧

下一篇,我會帶你實際操作 & 安裝設定流程,讓 Agent 真的能幫你管理筆記!
我們下次見~ (≧▽≦)/
reference link


上一篇
[Day 21] Spotify MCP Server(下)
系列文
AI Agent 開發養成記:做出屬於自己的Agent P22
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言