hackmd

基于MCP协议,让AI助手通过API管理HackMD笔记和团队协作内容。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:hackmd。
它的用途是:基于MCP协议,让AI助手通过API管理HackMD笔记和团队协作内容。
完整的 Skill 内容见:https://321skill.com/skills/hackmd/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我查找上周项目复盘会议上关于‘用户反馈’的讨论要点,并总结成一段摘要。”,它会通过MCP服务器查询HackMD中相关的会议笔记,提取关键信息并生成简洁的总结。或者

对AI说:“在‘产品需求’文件夹下创建一篇新笔记,标题是‘Q3功能规划’,并把我刚才说的几点想法列成大纲。”,它会自动在指定位置创建笔记并填充内容。

介绍

这个Skill解决的是AI助手无法直接、结构化地访问和管理HackMD平台上的笔记与团队协作内容的问题。它通过实现MCP(Model Context Protocol)协议,为AI助手提供了一个标准化的API接口,使其能够读取、创建、更新和搜索HackMD中的笔记,从而将AI的智能处理能力无缝融入知识管理和团队协作流程中。

使用时,你需要将HackMD的访问令牌配置给这个MCP服务器,然后在支持MCP的AI助手(如Claude Desktop)中连接该服务器。之后,你就可以直接通过自然语言指令,让AI助手帮你查找相关笔记、汇总会议纪要、起草新的技术文档或更新项目计划,所有操作都通过API在后台安全完成。

它非常适合需要频繁使用HackMD进行知识沉淀和项目协作的团队,特别是那些希望用AI提升信息检索和内容创作效率的成员。无论是快速从历史文档中查找解决方案,还是将零散的讨论整理成结构化文档,这个Skill都能显著减少手动操作。

建议在使用前确保HackMD账号具有相应的笔记访问权限,并注意API调用可能受速率限制。对于涉及高度敏感信息的笔记,请审慎评估通过AI助手访问的风险。初次配置时,请仔细核对MCP服务器的连接参数,确保通信安全。

核心特点

与通用的笔记管理工具不同,它专为HackMD平台深度定制,实现了完整的MCP协议,确保AI助手能以标准化、安全的方式与HackMD的API交互。相较于手动复制粘贴或使用非官方的爬虫脚本,它提供了官方API支持的、可编程的自动化内容管理能力。

注意事项

不适合需要离线操作或管理非HackMD平台(如Notion、Obsidian)笔记的场景。

常见问题

如何获取HackMD的访问令牌?

登录HackMD后,在用户设置中的「API令牌」部分生成。

这个Skill支持团队空间(Team Workspace)的笔记吗?

支持,只要配置的令牌拥有对应团队空间的访问权限即可。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/hackmd/raw/index.md 读取 hackmd 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。