适合谁
- 需要将 HackMD 笔记管理集成到 AI 工作流的开发者
- 希望使用自然语言操作笔记的个人或团队
- 需要在云平台上部署 MCP 服务器的用户
H
58FMRS · C
该服务器功能专一，专注于 HackMD 笔记管理，实现了对笔记、团队、历史和用户资料的 CRUD 操作。安装简单，支持多种传输方式，适合集成到支持 MCP 的 AI 客户端中。安全性依赖于用户对 API 令牌的保护。
这是一个 Model Context Protocol（MCP）服务器，通过 HackMD API 与 HackMD 笔记平台交互，使 LLM 客户端能够访问和操作 HackMD 笔记、团队、用户资料和历史数据。支持 STDIO 和 HTTP 传输，可通过 Smithery 等平台进行云部署。
工具能力
get_user_info
获取当前认证用户的信息
list_teams
列出用户可访问的所有团队
get_history
获取用户的阅读历史
list_team_notes
列出团队中的所有笔记
create_team_note
在团队中创建新笔记
update_team_note
更新团队中的现有笔记
delete_team_note
删除团队中的笔记
list_user_notes
列出用户拥有的所有笔记
get_note
通过笔记 ID 获取笔记
create_note
创建新笔记
update_note
更新现有笔记
delete_note
删除笔记
安装接入
- 确保已安装 Node.js 18+。
- 在 MCP 客户端配置文件中添加上述配置（例如 mcp.json 或 claude_desktop_config.json）。
- 重启 MCP 客户端。
- 开始使用工具与 HackMD 交互。
claude_desktop_config.json
{
"mcpServers": {
"hackmd": {
"command": "npx",
"args": ["-y", "hackmd-mcp"],
"env": {
"HACKMD_API_TOKEN": "your_api_token"
}
}
}
}
选型与风险
不适合谁
- 不适合没有 HackMD API 令牌的用户
- 不适合需要离线访问笔记的场景（服务器依赖网络 API）
- 不适合需要高级协作功能（如实时协同编辑）的场景，因为该服务器主要提供 CRUD 操作
所需权限
- 需要 HackMD API 令牌（HACKMD_API_TOKEN）以认证所有操作
- 服务器可以读取和修改用户资料、笔记、团队、历史等数据，具体权限取决于令牌的权限范围
风险与副作用
- API 令牌泄露可能导致账户被未授权访问，请勿提交到版本控制
- HTTP 传输模式下，如果服务器托管时未保护端点，任何访问者都可能使用您的令牌
- 服务器会修改用户数据（创建、更新、删除笔记），操作前请确认
常见排障
- 检查 HACKMD_API_TOKEN 是否正确设置且未过期
- 确认网络连接正常，能访问 HackMD API
- 查看 MCP 客户端的日志，检查是否有错误信息
- 如果是 HTTP 传输，确认 ALLOWED_HACKMD_API_URLS 配置正确，否则请求可能被拒绝
使用场景
通过 AI 助手快速创建和管理 HackMD 笔记
让 AI 列出并整理用户的笔记和团队笔记
自动化团队协作中的笔记更新与归档
支持客户端
Claude Desktop完整支持