HackMD MCP-сервер

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

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

• Список заметок пользователя

• Создавайте, читайте, обновляйте и удаляйте заметки

• Посмотреть историю прочтений

• Работа с командными заметками

Требования

• Node.js 18+

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

• 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 :

Установка через mcp-get

Ручная установка

1. Добавьте этот сервер в ваш claude_desktop_config.json :

2. Перезагрузить рабочий стол Клода

3. Используйте инструменты для взаимодействия с вашей учетной записью 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 : Удалить заметку в команде

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

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

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

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

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

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

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

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

Отладка с помощью MCP Inspector

Вы можете использовать MCP Inspector для тестирования и отладки сервера HackMD MCP:

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

1. Подключитесь к работающему серверу HackMD MCP

2. Просмотрите доступные инструменты

3. Запуск инструментов с пользовательскими параметрами

4. Посмотреть ответы

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

Докер

Извлечение из Docker Hub:

Сборка Docker (локальная разработка):

Мультиплатформенная сборка Docker (локальная разработка):

Уведомление о безопасности

Этот сервер MCP требует ваш токен API HackMD в файле .env или в качестве переменной среды. Сохраните эту информацию в безопасности и никогда не передавайте ее в систему контроля версий.

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .