Harvest自然言語時間入力MCPサーバー
自然言語を使用してHarvestのタイムエントリを記録できるMCPサーバー。休暇申請などの特別な処理も含みます。このサーバーは、自然言語入力を理解し、休暇申請などの一般的なシナリオを自動的に処理することで、時間管理をより直感的にします。
特徴
🗣️ 自然言語による時間入力解析
🏖️ 特別休暇申請の処理（例：「今日は病気で休みです」）
⏰ 勤務時間の設定が可能
🌍 タイムゾーンのサポート
🎯 プロジェクトとタスクの自動マッチング
📅 スマートな日付解析（今日、昨日など）
Related MCP server: Harvest MCP Server
前提条件
Node.jsがインストールされている
ハーベストの記録
Harvest Developer Toolsからの個人アクセス トークン
アカウントID（トークンと同じページに表示されます）
インストール
インストール
Claudeデスクトップアプリをインストールする
このリポジトリをクローンします:
依存関係をインストールしてビルドします。
セットアップ スクリプトを実行します。
指示に従って以下を入力してください:
Harvest 個人アクセス トークン ( https://id.getharvest.com/developersから)
ハーベストアカウントID
標準労働時間（デフォルト：7.5）
タイムゾーン（デフォルト：オーストラリア/パース）
Claudeデスクトップアプリを再起動します
これで完了です。これで、Claude で自然言語による時間追跡が使用できるようになりました。
最新情報を入手
最新バージョンに更新するには:
セットアップ スクリプトにより、Claude はサーバーのローカル ビルドを使用するように構成されるため、取得した更新は再構築後に自動的に利用できるようになります。
使用法
サーバーは、Harvest と対話するためのいくつかのツールを提供します。
ログ時間
自然言語を使用して時間エントリを記録します。例:
通常時間のエントリ:
休暇申請（標準の勤務時間を自動的に使用します）:
タイムレポートを取得する
自然言語クエリを使用して時間レポートを取得します。例:
期間オプション:
レポートの種類:
プロジェクト別（デフォルト）:
"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"
レポートの詳細: 各レポートには次の内容が含まれます。
総労働時間
請求可能な時間と請求不可能な時間
請求可能金額（許可されている場合）
レポートタイプに基づいたプロジェクト/クライアント/タスク/ユーザーの詳細
プロジェクト一覧
利用可能なすべての Harvest プロジェクトを一覧表示します。
タスク一覧
特定のプロジェクトで利用可能なタスクを一覧表示します。
リストエントリ
最近の時間エントリを表示します:
構成
サーバーは次の環境変数をサポートしています:
HARVEST_ACCESS_TOKEN: Harvest個人アクセストークンHARVEST_ACCOUNT_ID: HarvestアカウントIDSTANDARD_WORK_DAY_HOURS: 1日の労働時間のデフォルト（デフォルト: 7.5）TIMEZONE: あなたのタイムゾーン (デフォルト: オーストラリア/パース)
発達
サーバーは以下を使用して構築されます:
タイプスクリプト
MCP SDK
自然言語による日付解析のための chrono-node
ハーベスト API v2
貢献するには:
リポジトリをフォークする
機能ブランチを作成する
プルリクエストを送信する
ライセンス
MITライセンス - 詳細はライセンスを参照