HackMD MCP-сервер

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

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

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

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

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

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

Требования

• Node.js 18+

Related MCP server: MCP Kibela

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

• 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

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

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

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

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 : Удалить заметку в команде

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

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

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

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

cp .env.example .env

2. Отредактируйте файл .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. Оттуда вы можете:

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

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

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

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

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

Докер

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

Лицензия

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