HackMD MCP サーバー
これは、HackMD APIとやり取りするためのモデルコンテキストプロトコル（MCP）サーバーです。AIアシスタントは、以下の操作を実行できます。
ユーザー情報を取得する
ユーザーのメモを一覧表示する
メモの作成、閲覧、更新、削除
閲覧履歴を表示
チームノートで作業する
要件
Node.js 18歳以上
Related MCP server: Appwrite MCP Server
環境変数
HACKMD_API_TOKEN: [必須] HackMD APIトークンHACKMD_API_URL: (オプション) HackMD APIエンドポイントURL。デフォルト:https://api.hackmd.io/v1
HackMD 設定から API トークンを取得できます。
Claude Desktop（またはその他のMCPクライアント）にインストールします
Smithery経由でインストール
Smithery経由で Claude Desktop 用の HackMD MCP Server を自動的にインストールするには:
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手動インストール
このサーバーを
claude_desktop_config.jsonに追加します。
{
"mcpServers": {
"hackmd": {
"command": "npx",
"args": ["-y", "hackmd-mcp"],
"env": {
"HACKMD_API_TOKEN": "your_api_token"
}
}
}
}Claudeデスクトップを再起動します
HackMDアカウントを操作するためのツールを使用する
利用可能なツール
ユーザーAPI
get_user_info : 認証されたユーザーに関する情報を取得する
ユーザーノートAPI
list_user_notes : ユーザーが所有するすべてのノートを一覧表示する
get_note : IDでノートを取得する
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構成
次の例をコピーして
.envファイルを作成します。
cp .env.example .env.envファイルを編集し、HackMD API トークンを追加します。
HACKMD_API_TOKEN=your_api_tokenMCP 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インターフェースにアクセスします。そこから以下の操作が可能です。
実行中のHackMD MCPサーバーに接続します
利用可能なツールを参照する
カスタムパラメータでツールを実行する
回答を見る
これは、Claude または他の AI アシスタントに接続する前にセットアップをテストする場合に特に便利です。
ドッカー
Docker Hub からプル:
docker pull yuna0x0/hackmd-mcpDocker ビルド (ローカル開発):
docker build -t yuna0x0/hackmd-mcp .Docker マルチプラットフォーム ビルド (ローカル開発):
docker buildx build --platform linux/amd64,linux/arm64 -t yuna0x0/hackmd-mcp .セキュリティに関するお知らせ
このMCPサーバーでは、HackMD APIトークンを.envファイルまたは環境変数として保存する必要があります。この情報は安全に保管し、バージョン管理にコミットしないでください。
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。