Harvest MCP Server

🚀 自然言語に基づく時間入力 Harvest MCP サーバー

この MCP サーバーは、自然言語を使用して Harvest の時間入力を記録することを可能にし、特に休暇申請に対する特殊な処理をサポートしています。自然言語入力を理解し、休暇申請などの一般的なシーンを自動的に処理することで、時間の追跡をより直感的に行えるようにします。

✨ 主な機能

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

📦 インストール

インストールの前提条件

• Node.js がインストールされていること
• Harvest アカウントを持っていること
• Harvest 開発者ツール から取得した個人用アクセストークン
• アカウント 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 から取得）
   • Harvest アカウント ID
   • 標準の平日勤務時間（デフォルト：7.5 時間）
   • タイムゾーン（デフォルト：オーストラリアのパース）
6. Claude デスクトップアプリケーションを再起動します。

これで完了です！Claude で自然言語による時間追跡を使用できます。

更新手順

最新バージョンに更新するには、以下のコマンドを実行します。

git pull
npm install
npm run build

設定スクリプトはローカルでビルドしたサーバーを使用するように構成されているため、再ビルド後に自動的に更新が適用されます。

💻 使用例

このサーバーは、Harvest とのやり取りに使用できるさまざまなツールを提供しています。

log_time

自然言語を使用して時間を記録します。例：

通常の時間入力：

"今日はプロジェクト X で開発作業を 2 時間行いました"
"昨日はプロジェクト Y でテストを 45 分間行いました"
"先週の金曜日はプロジェクト Z で会議を 3.5 時間行いました"

休暇申請（自動的に標準の平日勤務時間が適用されます）：

"私は今日病欠です"
"私は今日具合が悪いです"
"来週は休暇です"

get_time_report

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

1. 期間のオプション：

"先月の時間レポートを表示してください"
"今週の概要を取得してください"
"1 月 1 日から 1 月 31 日までの時間を表示してください"
"第 1 四半期の時間を表示してください"
"昨日の時間を表示してください"

2. レポートのタイプ：

• プロジェクト別の集計
• タスク別のグループ化
• トレンド分析の表示

get_help

利用可能なコマンドのリストと簡単な説明を取得します。

get_help

📚 ドキュメント

以下の環境変数を設定することで、サーバーを構成できます。

• PORT - サービスが実行されるポート（デフォルト：3000）
• DB_URL - データベースの接続 URL
• TOKEN_SECRET - アクセストークンの秘密鍵

🔧 技術詳細

技術スタック

• バックエンド：Node.js、Express
• データベース：MongoDB
• プログラミング言語：JavaScript/TypeScript

貢献ガイド

1. リポジトリをクローンし、依存関係をインストールします。

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

2. 機能ブランチを作成し、変更をコミットします。

git checkout -b feature/new-feature
# 変更を行う
git add .
git commit -m "新機能の追加"
git push origin feature/new-feature

3. メインブランチにプルリクエストを送信します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細については、LICENSE ファイルを参照してください。