JinDaGe - hackmd-mcp MCP Details

article

README

🚀 HackMD MCP 服务器

这是一个用于与 HackMD API 交互的 Model Context Protocol (MCP) 服务器。它能让 AI 助手完成以下操作，为用户提供便捷的笔记管理体验：

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

🚀 快速开始

该 HackMD MCP 服务器可助力 AI 助手与 HackMD API 实现交互，为用户提供笔记管理等功能。

✨ 主要特性

丰富的笔记操作：支持对笔记进行创建、读取、更新和删除等操作。
用户信息管理：能够获取用户信息并查看阅读历史记录。
团队笔记处理：可对团队笔记进行有效管理。

📦 安装指南

需求

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 自动将 HackMD MCP 服务器安装到 Claude Desktop，可使用以下命令：

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

手动安装

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

{
  "mcpServers": {
    "hackmd": {
      "command": "node",
      "args": ["index.js"]
    }
  }
}

根据需要设置环境变量。

hackmd-mcp