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

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

特徴

• 🗣️ 自然言語による時間入力解析

• 🏖️ 特別休暇申請の処理（例：「今日は病気で休みです」）

• ⏰ 勤務時間の設定が可能

• 🌍 タイムゾーンのサポート

• 🎯 プロジェクトとタスクの自動マッチング

• 📅 スマートな日付解析（今日、昨日など）

Related MCP server: Harvest MCP Server

前提条件

• Node.jsがインストールされている

• ハーベストの記録

• Harvest Developer Toolsからの個人アクセス トークン

• アカウントID（トークンと同じページに表示されます）

インストール

インストール

1. Claudeデスクトップアプリをインストールする

2. このリポジトリをクローンします:

git clone https://github.com/adrian-dotco/harvest-mcp-server.git
cd harvest-mcp-server

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

npm install
npm run build

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

node build/setup.js

5. 指示に従って以下を入力してください:

   • Harvest 個人アクセス トークン ( https://id.getharvest.com/developersから)

   • ハーベストアカウントID

   • 標準労働時間（デフォルト：7.5）

   • タイムゾーン（デフォルト：オーストラリア/パース）

6. Claudeデスクトップアプリを再起動します

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

最新情報を入手

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

git pull
npm install
npm run build

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

使用法

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

ログ時間

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

通常時間のエントリ:

"2 hours on Project X doing development work today"
"45 minutes on Project Y testing yesterday"
"3.5 hours on Project Z meetings last Friday"

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

"I'm off sick today"
"I'm unwell today"
"Taking annual leave next week"

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

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

1. 期間オプション:

"Show time report for last month"
"Get time summary for this week"
"Show hours from January 1st to January 31st"
"Report time for Q1"
"Show me yesterday's hours"

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 プロジェクトを一覧表示します。

List my projects

タスク一覧

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

Show tasks for Project X

リストエントリ

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

Show my recent time entries

構成

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

• 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ライセンス - 詳細はライセンスを参照