里程碑
一个MCP服务器，帮助开发人员在不切换上下文的情况下分享他们的内置公共旅程。它从git历史中提取上下文，并帮助为社交平台生成里程碑更新。
它的作用
当你在编码时达到一个里程碑时，让你的人工智能助手起草并发布更新。Milestoner会自动提取您的git上下文，并帮助生成适合平台的内容。
目前支持的平台：
- 蓝天
安装
使用紫外线（推荐）
# Clone the repository
git clone https://github.com/J3r3my97/milestoner.git
cd milestoner
# Install with uv
uv pip install -e .使用pip
pip install -e .配置
克劳德代码
添加到您的Claude Code MCP设置中(~/.claude/claude_desktop_config.json 或通过克劳德代码设置）：
{
"mcpServers": {
"milestoner": {
"command": "uv",
"args": ["run", "--directory", "/path/to/milestoner", "milestoner"]
}
}
}或者，如果全局安装：
{
"mcpServers": {
"milestoner": {
"command": "milestoner"
}
}
}克劳德桌面版
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：
{
"mcpServers": {
"milestoner": {
"command": "uv",
"args": ["run", "--directory", "/path/to/milestoner", "milestoner"]
}
}
}设置
1.创建Bluesky应用程序密码
- 首选 bsky.app/settings/app-passwords
- 点击“添加应用密码”
- 给它起个名字（例如，“里程碑”）
- 复制生成的密码
2.配置Milestoner
问你的AI助手：
“使用我的Bluesky帐户配置milestoner。我的用户名是yourname.bsky.social，我的应用程序密码是xxxx-xxxx-xxxx”
助理将使用 configure 安全保存凭据的工具。
用法
看看你一直在做什么
“本周我做了什么值得发布的事情？”
助理将使用 list_activity 按天分组显示您最近的提交。
起草更新
“起草一篇关于我刚刚发布的身份验证功能的帖子”
助理将使用 draft_update 要获取git上下文，请生成一篇文章供您审阅。
发布更新
“将此更新发布到Bluesky”
助理将使用 post_update 发布您的内容并返回实时帖子的链接。
安排最佳时间
“将此帖子安排在今天的最佳时间”
助理将使用 schedule_post 随着 use_optimal_time: true 排队等待你的帖子达到高峰（例如，周三上午10点，工作日上午）。
检查最佳发布时间
“今天什么时候发帖最好？”
助理将使用 get_optimal_times 根据参与度研究，向您展示最佳时间。
工具
list_activity
显示最近可以发布的git活动。
输入：
repo_path（可选）：git repo的路径。默认为当前目录。since（可选）：回头看多远。默认为“7天”。
draft_update
获取用于起草社交媒体帖子的结构化上下文。
输入：
context（可选）：关注什么（例如，“刚刚发货的身份验证”）style（可选）：音调-casual,announcement,technical,storytellingrepo_path（可选）：git仓库路径commit_range（可选）：特定的提交（例如，“abc123..def456”或“最后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旨在支持多个平台。要添加新平台，请执行以下操作：
- 在中创建新文件
src/milestoner/platforms/（例如。，twitter.py) - 实施
Platform抽象基类 - 将平台添加到注册表中
src/milestoner/platforms/registry.py
看 src/milestoner/platforms/bluesky.py 作为示例实现。
许可证
麻省理工学院