Timing MCP Server

Timing MCP サーバー

Timing アプリケーションの機能を利用するための Model Context Protocol（MCP）サーバーです。 このサーバーを使うと、AI アシスタントが Timing の機能を利用できるようになり、ユーザーは時間の記録やタスクをより効率的に管理できます。

警告

このリポジトリは Timing とは提携していません。Timing アプリケーションの機能を強化するために作成された独立したプロジェクトです。

前提条件

始める前に、以下がインストールされていることを確認してください。

• Node.js（バージョン X.X.X 以上を推奨）
• npm（通常は Node.js に付属しています）
• Timing アカウント（API アクセス用）

インストール

1. リポジトリをクローンします。

   git clone https://github.com/your-username/timing-mcp-server.git
   cd timing-mcp-server
   

2. 依存関係をインストールします。

   npm install
   

3. ビルドを実行します。

   npm run build
   

設定

以下の JSON を、適切な {{PATH}} の値に置き換えてコピーしてください。

{
  "mcpServer": {
    "timing": {
      "command": "node",
      "args": ["{{PATH}}/dist/index.js"],
      "env": {
        "TIMING_API_KEY": "{{YOUR_TIMING_API_KEY}}"
      }
    }
  }
}

Timing API キーはこちらから取得できます。

Claude の場合は、これを Claude Desktop の設定ディレクトリにある claude_desktop_config.json として保存してください。

~/Library/Application Support/Claude/claude_desktop_config.json

Cursor の場合は、以下の Cursor 設定ディレクトリにある mcp.json として保存してください。

~/.cursor/mcp.json

利用可能なツール

ツール名	説明
timing_list_projects	Timing のプロジェクト一覧を取得します
timing_project	プロジェクトの詳細を取得します
timing_create_project	新しいプロジェクトを作成します
timing_update_project	既存のプロジェクトを更新します
timing_start_time_entry	新しい時間記録を開始します
timing_stop_time_entry	現在の時間記録を停止します
timing_list_time_entries	時間記録の一覧を取得します
timing_create_time_entry	新しい時間記録を作成します
timing_time_entry	時間記録の詳細を取得します
timing_update_time_entry	既存の時間記録を更新します
timing_generate_report	時間記録とアプリの使用状況をもとにレポートを生成します

コントリビューション

コントリビューションを歓迎します。コントリビューションをご希望の場合は、以下の手順に従ってください。

1. リポジトリをフォークします。
2. 新しいブランチを作成します（git checkout -b feature/your-feature-name）。
3. 変更を加えます。
4. 変更をコミットします（git commit -m 'Add some feature'）。
5. ブランチにプッシュします（git push origin feature/your-feature-name）。
6. プルリクエストを作成します。

必要に応じてテストも更新してください。

ライセンス

このプロジェクトはMIT Licenseの下でライセンスされています。