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 を自動的にインストールするには:
mcp-get 経由でインストールする
手動インストール
このサーバーを
claude_desktop_config.jsonに追加します。
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 : チーム内のノートを削除する
使用例
次に、次のようなコマンドを使用します。
地域開発
このプロジェクトではパッケージマネージャーとしてBunを使用しています。まだインストールしていない場合はインストールしてください。
リポジトリをクローンし、依存関係をインストールします。
構成
次の例をコピーして
.envファイルを作成します。
.envファイルを編集し、HackMD API トークンを追加します。
MCP Inspectorによるデバッグ
MCP Inspector を使用して HackMD MCP サーバーをテストおよびデバッグできます。
次に、ブラウザで指定されたURL（通常はhttp://127.0.0.1:6274 ）を開き、MCP Inspectorインターフェースにアクセスします。そこから以下の操作が可能です。
実行中のHackMD MCPサーバーに接続します
利用可能なツールを参照する
カスタムパラメータでツールを実行する
回答を見る
これは、Claude または他の AI アシスタントに接続する前にセットアップをテストする場合に特に便利です。
ドッカー
Docker Hub からプル:
Docker ビルド (ローカル開発):
Docker マルチプラットフォーム ビルド (ローカル開発):
セキュリティに関するお知らせ
このMCPサーバーでは、HackMD APIトークンを.envファイルまたは環境変数として保存する必要があります。この情報は安全に保管し、バージョン管理にコミットしないでください。
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。