MCP Server Harvest

🚀 収穫時間追跡 MCP サーバー

これは、収穫時間追跡アプリケーション用のTypeScriptベースのMCP（モデルコンテキストプロトコル）サーバーです。LLMクライアントが収穫アカウントとやり取りできるようにします。

🚀 クイックスタート

前提条件

• Bunランタイム
• APIアクセス権を持つ収穫アカウント
• 収穫から取得した個人アクセストークン
• アカウントID（収穫から取得）

詳細については、収穫APIドキュメントの個人アクセストークン作成の説明を参照してください。

✨ 主な機能

利用可能なツール

📦 インストール

Claude Desktopでの設定

settings.jsonファイルに以下の内容を追加してください。

{
  "mcpServers": {
    "Harvest": {
      "command": "npx",
      "args": [
        "@harvesttime/tracing-mcp-server",
        "--accountId",
        "<収穫アカウントID>",
        "--token",
        "<収穫個人アクセストークン>"
      ],
      "env": {}
    }
  }
}

Visual Studio Codeでの設定

launch.jsonファイルに以下の内容を追加してください。

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "収穫時間追跡MCPサーバーを起動",
      "type": "node",
      "request": "launch",
      "program": "$npmBin/file:@harvesttime/tracing-mcp-server",
      "args": [
        "--accountId",
        "<収穫アカウントID>",
        "--token",
        "<収穫個人アクセストークン>"
      ]
    }
  ]
}

VS Codeでの起動

1. ターミナルを開きます。
2. 以下のコマンドを実行します。

   npm install --global @harvesttime/tracing-mcp-server
   

3. 設定ファイルの「収穫時間追跡MCPサーバーを起動」設定を起動します。

コマンドラインでの使用

以下のコマンドを直接実行します。

@harvesttime/tracing-mcp-server --accountId <収穫アカウントID> --token <収穫個人アクセストークン>

🔧 開発

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

   npm install
   

3. 開発サーバーを起動します。

   npm run dev
   

4. テストを実行します。

   npm test
   

📤 コードの提出

1. 機能ブランチを作成します。

   git checkout -b feature/<機能名>
   

2. 変更をコミットします。

   git add .
   git commit -m "コミットメッセージ"
   

3. リモートリポジトリにプッシュし、プルリクエストを作成します。

   git push origin feature/<機能名>
   

🔧 メンテナンス

依存関係の更新

1. package.jsonの依存関係のバージョンを更新します。
2. 変更を保存します。
3. 更新された依存関係をインストールします。

   npm install
   

パッケージング

1. パッケージングコマンドを実行します。

   npm run build
   

🤝 貢献ガイド

貢献を歓迎します！以下の手順に従ってください。

1. リポジトリをフォークします。
2. 変更をコミットします。
3. プルリクエストを作成します。

コードがコード規範に準拠し、すべてのテストに合格していることを確認してください。