yuna0x0/hackmd-mcp

yuna0x0/hackmd-mcp

от yuna0x0
MCP сервер для интеграции с HackMD через API: создавайте, редактируйте и удаляйте заметки, управляйте командами, просматривайте профиль и историю. Полезен разработчикам, работающим с LLM-клиентами ...

HackMD MCP Server

A Model Context Protocol (MCP) server that interfaces with the HackMD API, allowing LLM clients to access and interact with HackMD notes, teams, user profiles, and history data.

Features

  • Get user profile information
  • Create, read, update, and delete notes
  • Manage team notes and collaborate with team members
  • Access reading history
  • List and manage teams
  • Dual transport support: Both HTTP and STDIO transports
  • Cloud deployment ready: Support Smithery and other platforms

Requirements

  • Node.js 18+

Local Installation (STDIO Transport)

  1. Add this server to your mcp.json / claude_desktop_config.json:
{
  "mcpServers": {
    "hackmd": {
      "command": "npx",
      "args": ["-y", "hackmd-mcp"],
      "env": {
        "HACKMD_API_TOKEN": "your_api_token"
      }
    }
  }
}

You may also optionally set the HACKMD_API_URL environment variable if you need to use a different HackMD API endpoint.

  1. Restart your MCP client (e.g., Claude Desktop)
  2. Use the tools to interact with HackMD

Часто задаваемые вопросы

Инструменты были проиндексированы:
create_noteвнешний мир

Создаёт новую заметку.

Параметры
  • payloadobjectобязательный

    Создать параметры заметки

create_team_noteвнешний мир

Создать новую заметку в команде

Параметры
  • payloadobjectобязательный

    Создать параметры заметки

  • teamPathstringобязательный

    Путь команды

delete_noteидемпотентныйвнешний мир

Удалить заметку

Параметры
  • noteIdstringобязательный

    Note ID

delete_team_noteидемпотентныйвнешний мир

Удалить заметку в команде

Параметры
  • noteIdstringобязательный

    Note ID

  • teamPathstringобязательный

    Путь команды

get_historyтолько чтениевнешний мир

Получить историю чтения пользователя

Параметры

Без параметров.

get_noteтолько чтениевнешний мир

Получить заметку по её ID

Параметры
  • noteIdstringобязательный

    Note ID

get_user_infoтолько чтениевнешний мир

Получить информацию об аутентифицированном пользователе

Параметры

Без параметров.

list_team_notesтолько чтениевнешний мир

Вывести список всех заметок в команде

Параметры
  • teamPathstringобязательный

    Путь команды

list_teamsтолько чтениевнешний мир

Выведи список всех команд, доступных пользователю

Параметры

Без параметров.

list_user_notesтолько чтениевнешний мир

Вывести список всех заметок, принадлежащих пользователю.

Параметры

Без параметров.

update_noteвнешний мир

Обновить существующую заметку

Параметры
  • noteIdstringобязательный

    Note ID

  • payloadobjectобязательный

    Обновляет параметры заметки.

update_team_noteвнешний мир

Обновить существующую заметку в команде

Параметры
  • noteIdstringобязательный

    Note ID

  • optionsobjectобязательный

    Обновляет параметры заметки.

  • teamPathstringобязательный

    Путь команды

1.5.7основная
1.5.6
1.5.5
1.5.4
1.5.3
1.5.2
1.5.1
1.5.0
1.4.2
1.4.1
1.4.0
1.3.1
1.3.0
1.2.8
1.2.7
1.2.6
1.2.4
1.2.3
1.2.2
1.2.1
1.2.0
1.1.6
1.1.5
1.1.4
1.1.3
1.1.2
1.1.1
1.1.0
1.0.7
1.0.6
1.0.5
1.0.4
1.0.3
1.0.2
1.0.1
1.0.0

Выберите клиент, чтобы установить yuna0x0/hackmd-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

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

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

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

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"yuna0x0-hackmd-mcp-tjtzmrv77p\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"hackmd-mcp\"],\"env\":{\"HACKMD_API_TOKEN\":\"your_api_token\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "yuna0x0-hackmd-mcp-tjtzmrv77p": {
      "command": "npx",
      "args": [
        "-y",
        "hackmd-mcp"
      ],
      "env": {
        "HACKMD_API_TOKEN": "your_api_token"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add yuna0x0-hackmd-mcp-tjtzmrv77p --env HACKMD_API_TOKEN=your_api_token -- npx -y hackmd-mcp

Либо через JSON-конфиг:

claude mcp add-json yuna0x0-hackmd-mcp-tjtzmrv77p "{\"command\":\"npx\",\"args\":[\"-y\",\"hackmd-mcp\"],\"env\":{\"HACKMD_API_TOKEN\":\"your_api_token\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add yuna0x0-hackmd-mcp-tjtzmrv77p --env HACKMD_API_TOKEN=your_api_token -- npx -y hackmd-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.yuna0x0-hackmd-mcp-tjtzmrv77p]
command = "npx"
args = ["-y", "hackmd-mcp"]

[mcp_servers.yuna0x0-hackmd-mcp-tjtzmrv77p.env]
HACKMD_API_TOKEN = "your_api_token"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите yuna0x0/hackmd-mcp, а в поле команды запуска — строку ниже:
npx -y hackmd-mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "yuna0x0-hackmd-mcp-tjtzmrv77p": {
      "command": "npx",
      "args": [
        "-y",
        "hackmd-mcp"
      ],
      "env": {
        "HACKMD_API_TOKEN": "your_api_token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например yuna0x0-hackmd-mcp-tjtzmrv77p.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: yuna0x0-hackmd-mcp-tjtzmrv77p
    command: npx
    args:
      - "-y"
      - "hackmd-mcp"
    env:
      HACKMD_API_TOKEN: your_api_token
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

Похожие MCP-сервера

henilcalagiya/mcp-apple-notes

henilcalagiya/mcp-apple-notes

от henilcalagiya

MCP-сервер для автоматизации Apple Notes на macOS. Создавайте, редактируйте и удаляйте заметки и папки, ищите по ключевым словам. Работает с MCP-клиентами (Continue.dev, Claude Desktop). Основан на...

Python⭐ 52
smith-and-web/obsidian-mcp-server

smith-and-web/obsidian-mcp-server

от smith-and-web

MCP-сервер для интеграции AI-ассистентов с Obsidian: создавайте, читайте, редактируйте заметки, управляйте тегами и ищите по хранилищу через естественный язык. Полезен для автоматизации работы с за...

TypeScript⭐ 19
Notion MCP

Notion MCP

официальный

от makenotion

Notion MCP сервер даёт AI-агентам прямой доступ к Notion через API: читайте и редактируйте страницы в Markdown, делайте запросы к данным. Разработчики используют этот MCP инструмент для интеграции помощников с заметками и проектами, экономя токены.

TypeScript⭐ 4673
kj455/mcp-kibela

kj455/mcp-kibela

от kj455

MCP-сервер для интеграции AI-ассистентов с корпоративной базой знаний Kibela. Умеет искать заметки по ключевым словам, получать содержимое по ID или пути, создавать и редактировать записи — идеальн...

TypeScript⭐ 13
MarkusPfundstein/mcp-obsidian

MarkusPfundstein/mcp-obsidian

от markuspfundstein

Управляет заметками Obsidian: ищет по ключевым словам, читает, дополняет и создаёт новые. Требуется плагин Local REST API.

Python⭐ 4482
akseyh/bear-mcp-server

akseyh/bear-mcp-server

от akseyh

MCP-сервер для работы с заметками Bear Notes. Через SQLite читает все заметки, ищет по тексту и выводит теги. Интегрируется с MCP-клиентами (Claude Desktop) для автоматизации вашей базы знаний на m...

JavaScript⭐ 45
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин