maintenance-log

mcp-maintenance-log

公式 MCP レジストリに登録済みです（io.github.theluckystrike/maintenance-log）。 工房、賃貸物件、バンの車両群、またはスタジオ向けの mcp メンテナンス記録です。管理している機器すべてと、実施した作業を記録するローカル台帳をひとつにまとめます。各資産を一度登録し、名前、シリアル番号または資産タグ、設置場所を指定してから、サービスや修理のたびに、日付、作業内容、セント単位の費用、担当者、次回のサービス予定を記録します。次回予定は日付または日数間隔で指定できます。期限を尋ねると、期限超過の項目と今後 N 日以内に予定されている項目を報告します。結果は質問した時点の保存済みの日付から計算されるため、古くなりません。資産ごとの履歴には時系列の記録と合計費用が残り、エクスポートでは記録を CSV 形式のスプレッドシート用データ、または資産ごとの Markdown 要約として出力できます。すべてこのマシン内に保存され、アカウントもネットワーク通信も不要です。

theluckystrike が開発しました。

@theluckystrike/mcp-maintenance-log の npm 公開は保留中のため、現在 npx -y @theluckystrike/mcp-maintenance-log を実行すると 404 が返されます。それまでは、リポジトリをクローンしてビルドする方法をご利用ください。

インストール

Claude Desktop

macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json、Windows の場合は %APPDATA%\Claude\claude_desktop_config.json：

{
  "mcpServers": {
    "maintenance-log": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-maintenance-log"]
    }
  }
}

Claude Code

claude mcp add maintenance-log -- npx -y @theluckystrike/mcp-maintenance-log

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）。Claude Desktop と同じ項目を使用します。

ツール

ツール	機能
asset_add	資産を追加します。名前、シリアル番号または資産タグ、設置場所、メモ、通貨を指定します。AST-YYYY-NNNN を返します。重複するタグは登録できません
maintenance_log	資産の作業を記録します。日付、作業内容、セント単位の費用、技術者、次回予定日を指定します。next_due または interval_days のどちらか一方のみ指定できます
maintenance_due	期限レポートです。期限超過の日数、N 日以内（デフォルトは 30 日）に期限を迎える項目、さらに先の予定、予定が設定されていない項目を表示します。Pro
asset_history	資産 1 件の全履歴を表示します。すべての記録を時系列順に並べ、整数のセント単位で合計費用、技術者ごとの費用、現在設定されている予定を表示します
maintenance_export	指定した日付範囲の記録を CSV（無料）または資産ごとの Markdown 要約（Pro）として出力します
asset_remove	資産を削除します。記録がある資産は、失われる内容を明示する confirm: true がない限り削除できません。AST 番号が再発行されることはありません
license_status / license_activate	無料版または Pro、およびライセンスキーを確認します

無料版と Pro

	無料版	Pro
台帳に登録できる資産数	3	無制限
作業、費用、技術者の記録	はい	はい
資産ごとの履歴と合計費用	はい	はい
日付範囲を指定した CSV エクスポート	はい	はい
期限レポート：期限超過と N 日以内の期限	--	はい
資産ごとの Markdown 要約	--	はい

記録に利用制限はありません。作業記録と CSV エクスポートを含む 3 件の資産登録は、1 台の機械を扱う工場で実際に使える台帳です。記録した内容が制限されることはありません。Pro では台帳に登録できる資産数が増え、期限レポートと Markdown 要約が追加されます。

Pro を入手：https://mcp.zovo.one/buy/maintenance-log。このサーバー単体は 1 回限りの $19、バンドルは $39 です。

日付と金額

すべての日付は ISO 8601（YYYY-MM-DD）形式で保存されます。サービスの期限切れかどうかは、保存されることなく呼び出し時点の今日の日付から計算されるため、記録が古くなることはありません。間隔は作業を記録するときに一度だけ日付に変換されます。作業日から間隔分の日数を加算し、サーバーのタイムゾーンに左右されないよう UTC で計算します。すべての費用は、資産固有の通貨による整数のセント単位（1200 は 12.00）でエントリに保存されます。合計支出は保存済みエントリの合計なので、内訳との不整合が生じることはありません。

プライバシー

すべてのデータは ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/maintenance-log/ 内にローカル保存されます。ファイルは 2 つです。assets.json と counter.json です。データが外部に送信されることはなく、アカウントも API キーも必要ありません。また、このサーバーからネットワークへの呼び出しが行われることもありません。ライセンスキーはオフラインで検証されます。

theluckystrike が作成しました。https://github.com/theluckystrike

これらのドキュメントを MCP サーバーとして使用する

GitMCP を使えば、あらゆる MCP クライアント（Claude、Cursor、Windsurf、VS Code）から、このリポジトリのドキュメントをインストールなしで直接読み取れます。

• Docs MCP URL：https://gitmcp.io/theluckystrike/mcp-maintenance-log