Milestoner

🚀 Milestoner

開発者がコンテキストを切り替えることなく、公開中のビルドの進捗を共有できるようにするMCPサーバーです。Gitの履歴からコンテキストを取得し、ソーシャルプラットフォーム用のマイルストーン更新内容を生成するのを支援します。

🚀 クイックスタート

コーディング中にマイルストーンに到達したときに、AIアシスタントに更新内容の草案を作成して投稿するよう依頼できます。Milestonerは自動的にGitのコンテキストを取得し、プラットフォームに適したコンテンツを生成するのを支援します。

✨ 主な機能

• コーディング中のマイルストーン更新内容を自動的に生成する
• 複数のソーシャルプラットフォームに対応（現在はBlueskyのみ）
• Gitの履歴からコンテキストを取得し、適切な投稿内容を生成する

📦 インストール

uvを使用する方法（推奨）

# リポジトリをクローンする
git clone https://github.com/J3r3my97/milestoner.git
cd milestoner

# uvでインストールする
uv pip install -e .

pipを使用する方法

pip install -e .

💻 使用例

基本的な使用法

今週投稿する価値のあることを確認する

> "What have I done this week that's worth posting about?"

アシスタントはlist_activityを使用して、日別にグループ化された最近のコミットを表示します。

更新内容の草案を作成する

> "Draft a post about the authentication feature I just shipped"

アシスタントはdraft_updateを使用してGitのコンテキストを取得し、投稿内容の草案を生成します。

更新内容を投稿する

> "Post that update to Bluesky"

アシスタントはpost_updateを使用してコンテンツを公開し、投稿のリンクを返します。

最適な時間に投稿を予約する

> "Schedule this post for the best time today"

アシスタントはschedule_postをuse_optimal_time: trueで使用して、投稿を最適なタイミング（例：水曜日の午前10時、平日の朝）に予約します。

最適な投稿時間を確認する

> "When's the best time to post today?"

アシスタントはget_optimal_timesを使用して、エンゲージメントの研究に基づいた最適な投稿時間を表示します。

📚 ドキュメント

ツールの説明

list_activity

投稿する価値のある最近のGitアクティビティを表示します。

入力:

• repo_path (オプション): Gitリポジトリのパス。デフォルトは現在のディレクトリです。
• since (オプション): 遡る期間。デフォルトは "7 days" です。

draft_update

ソーシャルメディアの投稿草案を作成するための構造化されたコンテキストを取得します。

入力:

• context (オプション): 焦点を当てる内容（例: "just shipped auth"）
• style (オプション): トーン - casual, announcement, technical, storytelling
• repo_path (オプション): Gitリポジトリのパス
• commit_range (オプション): 特定のコミット（例: "abc123..def456" または "last 5"）
• platform (オプション): ターゲットのプラットフォーム（デフォルトは設定されたデフォルト値）

post_update

コンテンツをソーシャルプラットフォームに公開します。

入力:

• content (必須): 投稿するコンテンツ
• platform (オプション): ターゲットのプラットフォーム（デフォルトは設定されたデフォルト値）

configure

プラットフォームの資格情報を設定します。

入力:

• platform (必須): 設定するプラットフォーム（例: "bluesky"）
• handle: プラットフォーム上のハンドル
• app_password: 認証用のアプリパスワード
• set_default (オプション): これをデフォルトのプラットフォームとして設定する（デフォルト: true）

schedule_post

投稿を最適な時間に予約します。

入力:

• content (必須): 投稿するコンテンツ
• scheduled_for (オプション): 投稿するISO日時（例: "2025-01-15T10:00:00"）
• platform (オプション): ターゲットのプラットフォーム（デフォルトは設定されたデフォルト値）
• use_optimal_time (オプション): 次の最適な投稿時間に予約する

list_scheduled_posts

保留中の予約投稿と今後の最適な投稿時間を一覧表示します。

cancel_scheduled_post

予約投稿をキャンセルします。

入力:

• post_id (必須): キャンセルする予約投稿のID

get_optimal_times

エンゲージメントの研究に基づいた最適な投稿時間を取得します。返される情報:

• 現在の時間の質の評価
• 今日と明日の推奨投稿時間
• 今週の最適な時間（水曜日の午前10時）
• 避けるべき時間

リソース

milestoner://config

現在の設定状態とプラットフォームの接続状態を表示します。

milestoner://recent-posts

Milestonerを通じて行われた投稿の履歴を表示します。

設定の保存場所

資格情報は~/.milestoner/config.jsonに制限付きのファイルパーミッション（600）で保存されます。投稿履歴は~/.milestoner/post-history.jsonに保存されます。

新しいプラットフォームの追加方法

Milestonerは複数のプラットフォームをサポートするように設計されています。新しいプラットフォームを追加するには、以下の手順を実行します。

1. src/milestoner/platforms/に新しいファイルを作成します（例: twitter.py）
2. Platform抽象基底クラスを実装します
3. src/milestoner/platforms/registry.pyのレジストリにプラットフォームを追加します

実装例については、src/milestoner/platforms/bluesky.pyを参照してください。

📄 ライセンス

MITライセンスの下で公開されています。