Tempo MCP Server

🚀 Tempo MCP サーバー

このサーバーは、Jira 内の Tempo 工数記録を管理するための MCP サーバーです。Tempo の API を通じて時間の追跡や作業ログの管理ツールを提供し、Claude、Cursor およびその他の MCP プロトコルに対応したクライアントからアクセスできます。

🚀 クイックスタート

Tempo MCP サーバーは、Jira 内の Tempo 工数記録を管理するための便利なツールです。Tempo API を利用して時間の追跡や作業ログの管理が可能で、Claude、Cursor などの MCP プロトコル対応クライアントからアクセスできます。

✨ 主な機能

• 工数記録の取得: 特定の日付範囲内のすべての工数記録を取得します。
• 工数記録の作成: Jira の問題に対して時間を記録します。
• 一括作成: 一度の操作で複数の工数記録を作成します。
• 工数記録の編集: 既に記録された時間、日付、説明を変更します。
• 工数記録の削除: 既存の工数記録を削除します。

📦 インストール

システム要件

• Node.js 18+（LTS バージョンの使用を推奨）
• Jira Cloud インスタンス
• Tempo API トークン
• Jira API トークン

💻 使用例

この MCP サーバーを使用する主な方法は以下の 2 つです。

オプション 1: NPX を使用する方法（ほとんどのユーザーに推奨）

npx を使用すると、インストールせずに直接実行できます。

Claude デスクトップ版に接続する（NPX 方法）

1. MCP クライアントの設定ファイルを開きます。
   • macOS システム: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows システム: %APPDATA%\Claude\claude_desktop_config.json
2. 以下の設定を追加します。

{
  "mcpServers": {
    "Jira_Tempo": {
      "command": "npx",
      "args": [
        "@ivelin-web/tempo-mcp-server"
      ],
      "env": {
        "TEMPO_API_KEY": "your_tempo_api_key_here",
        "JIRA_SITE": "your_jira_site_url_here"
      }
    }
  }
}

3. ファイルを保存すると、Claude などのクライアントから MCP サーバーを使用できるようになります。

オプション 2: ローカルにクローンする

開発やカスタマイズのために、リポジトリをクローンします。

1. このリポジトリをローカルにクローンします。

git clone https://github.com/yourusername/tempo-mcp-server.git

2. プロジェクトディレクトリに移動し、依存関係をインストールします。

cd tempo-mcp-server
npm install

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

npm run dev

📚 ドキュメント

プロジェクト構造

tempo-mcp-server/
├── src/                  # ソースコードディレクトリ
│   ├── config.ts         # 設定管理ファイル
│   ├── index.ts          # MCP サーバー実装ファイル
│   ├── jira.ts           # Jira API 統合ファイル
│   ├── tools.ts          # ツール実装ファイル
│   ├── types.ts          # TypeScript 型とモード定義
│   └── utils.ts          # ヘルパー関数ファイル
├── build/                # コンパイルされた JavaScript コード
├── tsconfig.json         # TypeScript 設定ファイル
└── package.json          # プロジェクトメタデータとスクリプト設定

ツールの説明

以下は、MCP サーバーがサポートするツールとその詳細情報です。

工数記録の取得 (/list)

• 機能: すべての記録された工数記録をリストします。
• リクエストパラメータ:
  • worklogId: 特定の工数記録の ID（オプション）
• 戻り値: 工数記録の詳細情報を含む JSON 配列。

工数記録の作成 (/create)

• 機能: Jira の問題に新しい工数記録を作成します。
• リクエストパラメータ:
  • issueKey: 時間を記録する問題のキー
  • timeSpentHours: 費やした時間（時間）を表す正数
  • date: 工数記録の日付（YYYY-MM-DD 形式）
  • description: 説明内容（オプション）

工数記録の一括作成 (/bulk-create)

• 機能: 一度の操作で複数の工数記録を作成します。
• リクエストパラメータ:
  • worklogEntries: 以下の属性を含む配列。
    • issueKey: 時間を記録する問題のキー
    • timeSpentHours: 費やした時間（時間）を表す正数
    • date: 工数記録の日付（YYYY-MM-DD 形式）
    • description: 説明内容（オプション）

工数記録の編集 (/edit)

• 機能: 既存の工数記録を編集します。
• リクエストパラメータ:
  • worklogId: 編集する工数記録の ID
  • timeSpentHours: 新しい時間記録（時間）を表す正数
  • description: 新しい説明内容（オプション）
  • date: 新しい日付（YYYY-MM-DD 形式、オプション）

工数記録の削除 (/delete)

• 機能: 指定された工数記録を削除します。
• リクエストパラメータ:
  • worklogId: 削除する工数記録の ID

エラー処理とデバッグ

使用中に問題が発生した場合は、以下の手順で問題を解決してください。

1. すべての環境変数が正しく設定されていることを確認します。

echo $TEMPO_API_KEY && echo $JIRA_SITE

2. Tempo と Jira API トークンが正しい権限を持っていることを検証します。通常、以下の権限が必要です。
   • 問題の読み取りと書き込み権限
   • 工数記録の管理権限
3. コンソール出力のエラーメッセージを確認して、具体的な問題を特定します。
4. 問題が解決しない場合は、デバッグモードでサーバーを実行してみてください。

npm run inspect

📄 ライセンス

MIT

クレジット

このサーバーは、Anthropic が作成した モデルコンテキストプロトコル 仕様を実装しています。