HackMD MCP-сервер

значок кузнеца

Это сервер Model Context Protocol (MCP) для взаимодействия с API HackMD . Он позволяет помощникам ИИ выполнять такие операции, как:

Получить информацию о пользователе
Список заметок пользователя
Создавайте, читайте, обновляйте и удаляйте заметки
Посмотреть историю прочтений
Работа с командными заметками

Требования

Node.js 18+

Related MCP server: Appwrite MCP Server

Переменные среды

HACKMD_API_TOKEN : [Обязательно] Ваш токен API HackMD
HACKMD_API_URL : (Необязательно) URL конечной точки API HackMD. По умолчанию: https://api.hackmd.io/v1

API-токен можно получить в настройках HackMD .

Установить на Claude Desktop (или другие клиенты MCP)

Установка через Smithery

Чтобы автоматически установить HackMD MCP Server для Claude Desktop через Smithery :

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

# For other MCP clients, use the following command:
# List available clients
npx -y @smithery/cli list clients
# Install to other 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": "npx",
      "args": ["-y", "hackmd-mcp"],
      "env": {
        "HACKMD_API_TOKEN": "your_api_token"
      }
    }
  }
}

Перезагрузить рабочий стол Клода
Используйте инструменты для взаимодействия с вашей учетной записью HackMD

Доступные инструменты

Пользовательский API

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

API заметок пользователя

list_user_notes : Список всех заметок, принадлежащих пользователю
get_note : Получить заметку по ее идентификатору
create_note : Создать новую заметку
update_note : Обновить существующую заметку
delete_note : Удалить заметку
get_history : Получить историю чтения пользователя

API команд

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

API командных заметок

list_team_notes : Список всех заметок в команде
create_team_note : Создать новую заметку в команде
update_team_note : Обновить существующую заметку в команде
delete_team_note : Удалить заметку в команде

Пример использования

Can you help me manage my HackMD notes?

Затем используйте такие команды:

Please list all my notes.

Местное развитие

Этот проект использует Bun в качестве менеджера пакетов. Вам следует установить его, если вы еще этого не сделали.

Клонируйте репозиторий и установите зависимости:

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

Конфигурация

Создайте файл .env , скопировав пример:

cp .env.example .env

Отредактируйте файл .env и добавьте свой токен API HackMD:

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

# Use this instead when Local Development
bun run inspector

Затем откройте в браузере предоставленный URL (обычно http://127.0.0.1:6274 ), чтобы получить доступ к интерфейсу MCP Inspector. Оттуда вы можете:

Подключитесь к работающему серверу HackMD MCP
Просмотрите доступные инструменты
Запуск инструментов с пользовательскими параметрами
Посмотреть ответы

Это особенно полезно для тестирования вашей установки перед подключением ее к Клоду или другому помощнику на основе искусственного интеллекта.

Докер

Извлечение из 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 требует ваш токен API HackMD в файле .env или в качестве переменной среды. Сохраните эту информацию в безопасности и никогда не передавайте ее в систему контроля версий.