返回 MCP 目录
public公开dns本地运行

hackmd-mcp

HackMD MCP Server是一个基于Model Context Protocol的服务,允许AI助手通过HackMD API管理用户的笔记和团队协作内容。

article

README

🚀 HackMD MCP 服务器

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

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

smithery 徽章

🚀 快速开始

该 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

手动安装

  1. 将此服务器添加到您的 claude_desktop_config.json 中:
{
  "mcpServers": {
    "hackmd": {
      "command": "node",
      "args": ["index.js"]
    }
  }
}
  1. 根据需要设置环境变量。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端