job-card

mcp-job-card

公式 MCP Registry に登録されています（io.github.theluckystrike/job-card）。 仕事ごとに1枚のカードを作成します。ダッシュボードにある紙のカードと同じように使えます。クライアントと現場のカードを開き、各作業者が担当した時間を時給とともに記録し、仕事に使った材料を入力すると、カードには人件費、材料費、合計金額が整数のセント単位で常に集計されます。仕事の進捗に合わせて、カードを「open」「in progress」「done」「invoiced」「archived」と進められます。クライアントが確認したいときは、署名欄付きのカードを印刷して承認を得られます。日次または週次のサマリーでは、作業チームの時間の使い道と、通貨ごとの作業価値を確認できます。すべてこのマシン上に保存され、アカウントもネットワーク通信も必要ありません。

theluckystrike が開発しました。

@theluckystrike/mcp-job-card の npm 公開は保留中のため、現時点では npx -y @theluckystrike/mcp-job-card は 404 を返します。それまでは、リポジトリをクローンしてビルドする方法をお使いください。

インストール

Claude Desktop

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

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

Claude Code

claude mcp add job-card -- npx -y @theluckystrike/mcp-job-card

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）に、Claude Desktop と同じエントリーを追加します。

ツール

ツール	内容
job_card_create	仕事のカードを作成します。クライアント、現場、仕事内容、通貨、予定日を入力します。JC-YYYY-NNNN を返します
job_card_log_labor	カードに作業時間を記録します。作業者、日付、時間数、セント単位の時給、作業内容を入力します
job_card_log_material	カードに使用材料を記録します。品目、数量、セント単位の単価を入力します
job_card_update_status	カードを1段階ずつ「open」「in_progress」「done」「invoiced」「archived」へ進め、日付とメモを履歴に記録します
job_card_list	カードを新しい順に一覧表示し、時間数と合計を表示します。ステータスとクライアントで絞り込めます。合計は通貨ごとに集計されます
job_card_get	1枚のカードの全内容を読み取ります。すべての記録、作業者ごとの時間数、整数のセント単位での累計を確認できます
job_card_print	クライアントの承認用署名欄付きで、印刷できる形式にカードを出力します。Markdown または自己完結型 HTML に対応します
job_card_delete	誤って入力したカードを削除します。作業時間または材料の記録があるカードは削除できません。その場合はアーカイブしてください
job_card_summary	1日または1週間分のカードの更新状況、作業者ごとの時間数、通貨ごとの人件費と材料費を表示します。1週間は月曜日から日曜日までです
license_status / license_activate	Free または Pro のライセンス状況とキーを確認・有効化します

Free と Pro の比較

	Free	Pro
アクティブな仕事カード	10	無制限
カードごとの作業時間と材料の記録	無制限	無制限
累計、一覧表示、詳細表示	はい	はい
印刷可能なカード、Markdown と HTML	はい	はい
日次・週次サマリー	はい	はい

記録の利用量に応じた課金はありません。アクティブなカード10枚は小規模な作業チームにとって実用的な管理ボードであり、カードはアーカイブした時点でカウント対象から外れます。そのため、記録、集計、印刷、サマリーは今後も無料で使えます。Pro で上限が増えるのは、同時にボード上に置ける仕事の数です。

Pro を購入する：https://mcp.zovo.one/buy/job-card。このサーバー単体では一回限りの $19、バンドルでは $39 です。

金額と丸め

すべての金額は、セント単位の整数です（1セントは通貨単位の1/100です）。作業費の明細は時間数と時間単価の積、材料費の明細は数量と単価の積です。各明細の金額は記録時に一度だけ、最も近いセント単位に四捨五入され、エントリーに保存されます。合計は保存済みの明細金額の合計なので、合計が明細とずれることはありません。時間数は整数の100分の1単位、数量は整数の1000分の1単位で保持されるため、1時間あたり4999セントで2.5時間の場合、金額は常に12498セントとなり、12497.499999になることはありません。異なる通貨を合算することはありません。このサーバーは為替レートを保持していません。

プライバシー

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

theluckystrike によって開発されました。https://github.com/theluckystrike

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

Claude、Cursor、Windsurf、VS Code などのあらゆる MCP クライアントが、インストール不要で GitMCP を介してこのリポジトリのドキュメントを直接読み込めます。

• ドキュメント MCP URL：https://gitmcp.io/theluckystrike/mcp-job-card