yuna0x0/hackmd-mcp logo

yuna0x0/hackmd-mcp

Free

允许 AI 模型与 HackMD 交互。

FreeFree tier
Inputs: textOutputs: text
Type
Open Source

About yuna0x0/hackmd-mcp

HackMD MCP Server is an open-source Model Context Protocol (MCP) server that enables AI assistants to interact with the HackMD note-taking platform. It acts as a bridge between LLM clients and the HackMD API, allowing AI models to perform operations on notes, teams, user profiles, and history data. The server supports both HTTP and STDIO transports, making it flexible for local or cloud deployment. It is designed for developers and users who want to integrate HackMD's collaborative note-taking capabilities into AI workflows.

Key Features

Get user profile information from HackMD
Create, read, update, and delete notes
Manage team notes and collaborate with team members
Access reading history
List and manage teams
Dual transport support: HTTP and STDIO
Cloud deployment ready with support for Smithery and other platforms

Pros & Cons

Pros
  • Open-source and free to use
  • Enables AI models to directly interact with HackMD notes and teams
  • Supports both local (STDIO) and cloud (HTTP) deployment
  • Cloud deployment ready with Smithery support
  • Provides a standardized MCP interface for HackMD integration
Cons
  • Requires a HackMD API token for authentication
  • Dependent on HackMD API availability and rate limits
  • Requires Node.js 18+ to run
  • Free tier of HackMD may have usage limits that affect functionality

Best For

Automating note creation and management via AI assistantsIntegrating HackMD notes into AI-powered workflowsCollaborative note-taking with team members through AI interfacesRetrieving and analyzing user reading historyBuilding custom AI tools that interact with HackMD data

FAQ

What is HackMD MCP Server?
It is an open-source MCP server that allows AI assistants to interact with the HackMD note-taking platform via the HackMD API.
How do I install HackMD MCP Server?
You can add it to your MCP client configuration (e.g., mcp.json or claude_desktop_config.json) using npx, and set the HACKMD_API_TOKEN environment variable. Detailed instructions are available on the GitHub repository.
What transport protocols does it support?
Based on available information, it supports both HTTP and STDIO transports.
Is HackMD MCP Server free?
The server itself is open-source and free. However, usage of the HackMD API may be subject to HackMD's own pricing and rate limits.
Can I deploy it to the cloud?
Yes, it supports cloud deployment, including platforms like Smithery. You can also self-host it using the HTTP transport.
What are the system requirements?
Node.js version 18 or higher is required.