Milestoner

🚀 Milestoner

Milestoner是一款MCP服務器，它能幫助開發者在無需切換上下文的情況下，分享他們公開構建的歷程。它會從git歷史記錄中提取上下文信息，並助力為社交平臺生成里程碑更新內容。

🚀 快速開始

當你在編碼過程中達成一個里程碑時，你可以讓你的AI助手起草併發布更新內容。Milestoner會自動提取你的git上下文信息，並協助生成適合平臺的內容。

✨ 主要特性

• 自動提取上下文：自動從git歷史記錄中提取上下文信息，無需手動整理。
• 多平臺支持：目前支持Bluesky平臺，且設計上可擴展支持更多平臺。
• AI輔助操作：藉助AI助手完成草稿起草、發佈、調度等操作。

📦 安裝指南

使用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?"

AI助手會使用list_activity工具，按天展示你最近的提交記錄。

起草更新內容

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

AI助手會使用draft_update工具獲取git上下文信息，然後為你生成一篇待審核的帖子。

發佈更新內容

> "Post that update to Bluesky"

AI助手會使用post_update工具發佈你的內容，並返回一個指向已發佈帖子的鏈接。

安排最佳發佈時間

> "Schedule this post for the best time today"

AI助手會使用schedule_post工具，設置use_optimal_time: true，將你的帖子安排在最佳互動時間發佈（例如週三上午10點、工作日上午）。

查看最佳發佈時間

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

AI助手會使用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許可證。