Harvest自然言語時間入力MCPサーバー

自然言語を使用してHarvestのタイムエントリを記録できるMCPサーバー。休暇申請などの特別な処理も含みます。このサーバーは、自然言語入力を理解し、休暇申請などの一般的なシナリオを自動的に処理することで、時間管理をより直感的にします。

特徴

• 🗣️ 自然言語による時間入力解析
• 🏖️ 特別休暇申請の処理（例：「今日は病気で休みです」）
• ⏰ 勤務時間の設定が可能
• 🌍 タイムゾーンのサポート
• 🎯 プロジェクトとタスクの自動マッチング
• 📅 スマートな日付解析（今日、昨日など）

前提条件

• Node.jsがインストールされている
• ハーベストの記録
• Harvest Developer Toolsからの個人アクセス トークン
• アカウントID（トークンと同じページに表示されます）

インストール

インストール

1. Claudeデスクトップアプリをインストールする
2. このリポジトリをクローンします:

3. 依存関係をインストールしてビルドします。

4. セットアップ スクリプトを実行します。

5. 指示に従って以下を入力してください:
   • Harvest 個人アクセス トークン ( https://id.getharvest.com/developersから)
   • ハーベストアカウントID
   • 標準労働時間（デフォルト：7.5）
   • タイムゾーン（デフォルト：オーストラリア/パース）
6. Claudeデスクトップアプリを再起動します

これで完了です。これで、Claude で自然言語による時間追跡が使用できるようになりました。

最新情報を入手

最新バージョンに更新するには:

セットアップ スクリプトにより、Claude はサーバーのローカル ビルドを使用するように構成されるため、取得した更新は再構築後に自動的に利用できるようになります。

使用法

サーバーは、Harvest と対話するためのいくつかのツールを提供します。

ログ時間

自然言語を使用して時間エントリを記録します。例:

通常時間のエントリ:

休暇申請（標準の勤務時間を自動的に使用します）:

タイムレポートを取得する

自然言語クエリを使用して時間レポートを取得します。例:

1. 期間オプション:

2. レポートの種類:

• プロジェクト別（デフォルト）:
  "Show time report for last month" "Get project hours for this week"
• クライアント別:
  "Show time report by client for this month" "Get hours by client for Q1"
• タスク別:
  "Show time summary by task for January" "Get task breakdown for last week"
• チームメンバー別:
  "Show team hours for last week" "Get time report by user for this month"

3. レポートの詳細: 各レポートには次の内容が含まれます。

• 総労働時間
• 請求可能な時間と請求不可能な時間
• 請求可能金額（許可されている場合）
• レポートタイプに基づいたプロジェクト/クライアント/タスク/ユーザーの詳細

プロジェクト一覧

利用可能なすべての Harvest プロジェクトを一覧表示します。

タスク一覧

特定のプロジェクトで利用可能なタスクを一覧表示します。

リストエントリ

最近の時間エントリを表示します:

構成

サーバーは次の環境変数をサポートしています:

• HARVEST_ACCESS_TOKEN : Harvest個人アクセストークン
• HARVEST_ACCOUNT_ID : HarvestアカウントID
• STANDARD_WORK_DAY_HOURS : 1日の労働時間のデフォルト（デフォルト: 7.5）
• TIMEZONE : あなたのタイムゾーン (デフォルト: オーストラリア/パース)

発達

サーバーは以下を使用して構築されます:

• タイプスクリプト
• MCP SDK
• 自然言語による日付解析のための chrono-node
• ハーベスト API v2

貢献するには:

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. プルリクエストを送信する

ライセンス

MITライセンス - 詳細はライセンスを参照