HackMD MCP 服务器

这是一个用于与 HackMD API 交互的模型上下文协议 (MCP) 服务器。它允许 AI 助手执行以下操作：

• 获取用户信息
• 列出用户的笔记
• 创建、读取、更新和删除笔记
• 查看阅读历史
• 处理团队笔记

要求

• Node.js 18+

环境变量

• HACKMD_API_TOKEN: [必需] 您的 HackMD API 令牌
• HACKMD_API_URL: (可选) HackMD API 端点 URL。默认值：https://api.hackmd.io/v1

您可以从 HackMD 设置 获取 API 令牌。

安装到 Claude Desktop（或其他 MCP 客户端）

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 HackMD MCP 服务器：

npx -y @smithery/cli install @yuna0x0/hackmd-mcp --client claude

# 对于其他 MCP 客户端，请使用以下命令：
# 列出可用的客户端
npx -y @smithery/cli list clients
# 安装到其他客户端
npx -y @smithery/cli install @yuna0x0/hackmd-mcp --client <client_name>

通过 mcp-get 安装

npx @michaellatman/mcp-get@latest install hackmd-mcp

手动安装

1. 将此服务器添加到您的 claude_desktop_config.json：

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

2. 重启 Claude Desktop
3. 使用这些工具与您的 HackMD 帐户交互

可用工具

用户 API

• get_user_info: 获取有关已验证用户的信息

用户笔记 API

• list_user_notes: 列出用户拥有的所有笔记
• get_note: 通过 ID 获取笔记
• create_note: 创建新笔记
• update_note: 更新现有笔记
• delete_note: 删除笔记
• get_history: 获取用户的阅读历史

团队 API

• list_teams: 列出用户可以访问的所有团队

团队笔记 API

• list_team_notes: 列出团队中的所有笔记
• create_team_note: 在团队中创建新笔记
• update_team_note: 更新团队中现有的笔记
• delete_team_note: 删除团队中的笔记

使用示例

你能帮我管理我的 HackMD 笔记吗？

然后使用如下命令：

请列出我的所有笔记。

本地开发

此项目使用 Bun 作为其包管理器。 如果您尚未安装，则应安装它。

克隆存储库并安装依赖项：

git clone https://github.com/yuna0x0/hackmd-mcp.git
cd hackmd-mcp
bun install

配置

1. 通过复制示例创建一个 .env 文件：

cp .env.example .env

2. 编辑 .env 文件并添加您的 HackMD API 令牌：

HACKMD_API_TOKEN=your_api_token

使用 MCP Inspector 调试

您可以使用 MCP Inspector 测试和调试 HackMD MCP 服务器：

npx @modelcontextprotocol/inspector -e HACKMD_API_TOKEN=your_api_token npx hackmd-mcp

# 本地开发时使用这个
bun run inspector

然后打开浏览器到提供的 URL（通常是 http://localhost:5173）以访问 MCP Inspector 界面。 在那里，您可以：

1. 连接到您正在运行的 HackMD MCP 服务器
2. 浏览可用的工具
3. 使用自定义参数运行工具
4. 查看响应

这对于在将设置连接到 Claude 或其他 AI 助手之前测试您的设置特别有用。

Docker

从 Docker Hub 拉取：

docker pull yuna0x0/hackmd-mcp

Docker 构建（本地开发）：

docker build -t yuna0x0/hackmd-mcp .

Docker 多平台构建（本地开发）：

docker buildx build --platform linux/amd64,linux/arm64 -t yuna0x0/hackmd-mcp .

安全提示

此 MCP 服务器需要在 .env 文件中或作为环境变量提供您的 HackMD API 令牌。 确保此信息的安全，并且永远不要将其提交到版本控制。

许可证

此项目已获得 MIT 许可证的许可 - 有关详细信息，请参阅 LICENSE 文件。