← 返回目录

HackMD MCP Server

社区

将 HackMD 笔记平台接入 AI 助手的 Model Context Protocol 服务器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 团队协作第 16 / 55
Stars: ★ 68 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 18+ · Docker
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 3 个月前
工具数: 12

58FMRS · C

该服务器功能专一，专注于 HackMD 笔记管理，实现了对笔记、团队、历史和用户资料的 CRUD 操作。安装简单，支持多种传输方式，适合集成到支持 MCP 的 AI 客户端中。安全性依赖于用户对 API 令牌的保护。

最强项 · 文档质量 15/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

10/20

维护活跃度

12/20

文档质量

15/20

安装易用性

14/20

查看各项评分依据

可靠性 7/20: 证据仅包含 README 和 server.json，没有源码、测试或 CI 结果。README 声称支持 stdio/HTTP、列出工具和示例，但无法核实 MCP 初始化握手、tool-list 是否与真实行为一致，也无法控制错误和依赖。由于没有可执行证据，按静态校准规则压低分数：功能路径看起来合理，但测试、边界情况和错误处理均无实证。
安全与权限 10/20: 令牌通过必填的秘密环境变量传递，也支持 HTTP 头；README 明确要求保护 HTTP 端点，并说明多个环境变量和 URL 白名单。但源码未提供，无法验证密钥不会被记录或外传；HTTP 传输未强制认证，delete_note/delete_team_note 等破坏性工具也没有任何确认机制的说明。主要风险可见，但权限最小化和确认/作用域仍不完整，因此给出中低分。
维护活跃度 12/20: 仓库未归档，MIT 许可，版本 1.5.7 并打包了 npm/OCI/MCPB 多种发行格式，README 也展示了 Docker 和 MCPB 流程。但缺少提交记录、发布时间、依赖更新策略和 issue 响应证据，仅有 star 数和 open issues 数不足以证明持续维护，因此扣分。
文档质量 15/20: README 覆盖安装、认证、环境变量、HTTP 头、令牌获取、工具列表、示例、本地开发、Inspector 调试、Docker、MCPB 和安全注意事项，整体分层且可用。但缺少每个工具的输入参数细节、错误码、API 限流/成本、故障排除和局限说明；文档声称的某些云平台行为也无可验证证据。
安装易用性 14/20: 提供了清晰的 npx 安装配置示例，可直接写入 mcp.json / claude_desktop_config.json，还额外提供 Docker、MCPB 和 Smithery 部署方式，步骤少且包含环境变量说明。然而没有真实 CI/测试证明安装后可成功连接，缺少对常见客户端配置问题的排障指引；按静态校准规则最高不超过 15，因此给出 14。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

需要将 HackMD 笔记管理集成到 AI 工作流的开发者
希望使用自然语言操作笔记的个人或团队
需要在云平台上部署 MCP 服务器的用户

不适合谁

不适合没有 HackMD API 令牌的用户
不适合需要离线访问笔记的场景（服务器依赖网络 API）
不适合需要高级协作功能（如实时协同编辑）的场景，因为该服务器主要提供 CRUD 操作

所需权限

需要 HackMD API 令牌（HACKMD_API_TOKEN）以认证所有操作
服务器可以读取和修改用户资料、笔记、团队、历史等数据，具体权限取决于令牌的权限范围

风险与副作用

API 令牌泄露可能导致账户被未授权访问，请勿提交到版本控制
HTTP 传输模式下，如果服务器托管时未保护端点，任何访问者都可能使用您的令牌
服务器会修改用户数据（创建、更新、删除笔记），操作前请确认

安装接入

准备工作

运行环境：Node.js 18+ · Docker

HACKMD_API_TOKEN 必填密钥 HackMD API 令牌，必填；在 https://hackmd.io/settings#api 点击 Create API Token 生成。

其他可选配置项（3 个）

HACKMD_API_URL 可选可选的 HackMD API 地址，默认为 https://api.hackmd.io/v1。

ALLOWED_HACKMD_API_URLS 可选仅 HTTP 传输时使用的可选白名单，逗号分隔的允许 HackMD API URL 列表。

PORT 可选仅 HTTP 传输服务器使用，可选，默认监听 8081 端口。

确保已安装 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"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "hackmd": {
      "command": "npx",
      "args": [
        "-y",
        "hackmd-mcp"
      ],
      "env": {
        "HACKMD_API_TOKEN": "your_api_token"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add hackmd -e HACKMD_API_TOKEN=your_api_token -- npx -y hackmd-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端（如 Claude Desktop）的工具列表中确认出现 get_user_info、list_notes 等工具，然后运行 get_user_info，若能返回已认证用户的资料即表示连接成功。

常见排障

检查 HACKMD_API_TOKEN 是否正确设置且未过期
确认网络连接正常，能访问 HackMD API
查看 MCP 客户端的日志，检查是否有错误信息
如果是 HTTP 传输，确认 ALLOWED_HACKMD_API_URLS 配置正确，否则请求可能被拒绝

试试这样问

连接成功后，可以直接对 AI 助手这样说：

请获取我的 HackMD 用户信息。
列出我所有的笔记。
创建一个标题为“会议记录”的新笔记，并写入讨论要点。
列出我所属的团队，并列出第一个团队中的所有笔记。

工具能力 12

get_user_info 只读

获取当前认证用户的信息

list_teams 只读

列出用户可访问的所有团队

get_history 只读

获取用户的阅读历史

list_team_notes 只读

列出团队中的所有笔记

create_team_note 写入

在团队中创建新笔记

update_team_note 写入

更新团队中的现有笔记

delete_team_note 破坏性

删除团队中的笔记

list_user_notes 只读

列出用户拥有的所有笔记

展开其余 4 个工具

get_note 只读

通过笔记 ID 获取笔记

create_note 写入

创建新笔记

update_note 写入

更新现有笔记

delete_note 破坏性

删除笔记

使用场景

通过 AI 助手快速创建和管理 HackMD 笔记

让 AI 列出并整理用户的笔记和团队笔记

自动化团队协作中的笔记更新与归档

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

这是一个 Model Context Protocol（MCP）服务器，通过 HackMD API 与 HackMD 笔记平台交互，使 LLM 客户端能够访问和操作 HackMD 笔记、团队、用户资料和历史数据。支持 STDIO 和 HTTP 传输，可通过 Smithery 等平台进行云部署。