Servidor MCP de HackMD

Este es un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API de HackMD . Permite a los asistentes de IA realizar operaciones como:

Obtener información del usuario
Lista de notas del usuario
Crear, leer, actualizar y eliminar notas
Ver historial de lectura
Trabajar con notas del equipo

Requisitos

Node.js 18+

Variables de entorno

HACKMD_API_TOKEN : [Obligatorio] Su token de API de HackMD
HACKMD_API_URL : (Opcional) URL del punto final de la API de HackMD. Predeterminado: https://api.hackmd.io/v1

Puede obtener un token API desde la configuración de HackMD .

Instalar en Claude Desktop (u otros clientes MCP)

Instalación mediante herrería

Para instalar HackMD MCP Server para Claude Desktop automáticamente a través de 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>

Instalación mediante mcp-get

npx @michaellatman/mcp-get@latest install hackmd-mcp

Instalación manual

Agregue este servidor a su claude_desktop_config.json :

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

Reiniciar Claude Desktop
Utilice las herramientas para interactuar con su cuenta de HackMD

Herramientas disponibles

API de usuario

get_user_info : Obtener información sobre el usuario autenticado

API de notas de usuario

list_user_notes : Lista todas las notas propiedad del usuario
get_note : Obtener una nota por su ID
create_note : Crea una nueva nota
update_note : Actualizar una nota existente
delete_note : Eliminar una nota
get_history : Obtener el historial de lectura del usuario

API de equipos

list_teams : enumera todos los equipos accesibles para el usuario

API de notas del equipo

list_team_notes : enumera todas las notas de un equipo
create_team_note : Crea una nueva nota en un equipo
update_team_note : Actualizar una nota existente en un equipo
delete_team_note : Eliminar una nota en un equipo

Ejemplo de uso

Can you help me manage my HackMD notes?

Luego use comandos como:

Please list all my notes.

Desarrollo local

Este proyecto usa Bun como gestor de paquetes. Deberías instalarlo si aún no lo has hecho.

Clonar el repositorio e instalar las dependencias:

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

Configuración

Cree un archivo .env copiando el ejemplo:

cp .env.example .env

Edite el archivo .env y agregue su token de API HackMD:

HACKMD_API_TOKEN=your_api_token

Depuración con MCP Inspector

Puede utilizar el Inspector MCP para probar y depurar el servidor MCP de HackMD:

npx @modelcontextprotocol/inspector -e HACKMD_API_TOKEN=your_api_token npx hackmd-mcp

# Use this instead when Local Development
bun run inspector

A continuación, abra su navegador y acceda a la URL proporcionada (normalmente http://127.0.0.1:6274 ) para acceder a la interfaz del Inspector de MCP. Desde allí, podrá:

Conéctese a su servidor HackMD MCP en ejecución
Explorar las herramientas disponibles
Ejecutar herramientas con parámetros personalizados
Ver las respuestas

Esto es particularmente útil para probar su configuración antes de conectarla a Claude u otro asistente de IA.

Estibador

Extraer de Docker Hub:

docker pull yuna0x0/hackmd-mcp

Compilación de Docker (desarrollo local):

docker build -t yuna0x0/hackmd-mcp .

Compilación multiplataforma de Docker (desarrollo local):

docker buildx build --platform linux/amd64,linux/arm64 -t yuna0x0/hackmd-mcp .

Aviso de seguridad

Este servidor MCP requiere su token de API de HackMD en el archivo .env o como variable de entorno. Mantenga esta información segura y nunca la envíe al control de versiones.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Un servidor de protocolo de contexto de modelo que permite a los asistentes de IA interactuar con la API de HackMD para administrar notas, incluida la creación, lectura, actualización y eliminación de notas.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Personal Assistant Agent
zhangzhongnan928
-
security
F
license
-
quality
A versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.
Last updated -
13
Python
Appwrite MCP Serverofficial
appwrite
A
security
A
license
A
quality
A Model Context Protocol server that allows AI assistants to interact with Appwrite's API, providing tools to manage databases, users, functions, teams, and other resources within Appwrite projects.
Last updated -
84
46
Python
MIT License
Healthcare MCP Server
Cicatriiz
A
security
A
license
A
quality
A Model Context Protocol server providing AI assistants with access to healthcare data tools, including FDA drug information, PubMed research, health topics, clinical trials, and medical terminology lookup.
Last updated -
7
69
18
JavaScript
MIT License
MCP Toolkit
zxfgds
-
security
F
license
-
quality
A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
Last updated -
16
1
TypeScript

View all related MCP servers

HackMD MCP Server