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+

Related MCP server: Appwrite MCP Server

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 :

Instalación mediante mcp-get

Instalación manual

1. Agregue este servidor a su claude_desktop_config.json :

2. Reiniciar Claude Desktop

3. 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

Luego use comandos como:

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:

Configuración

1. Cree un archivo .env copiando el ejemplo:

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

Depuración con MCP Inspector

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

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

1. Conéctese a su servidor HackMD MCP en ejecución

2. Explorar las herramientas disponibles

3. Ejecutar herramientas con parámetros personalizados

4. 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:

Compilación de Docker (desarrollo local):

Compilación multiplataforma de Docker (desarrollo local):

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.