bracker (Tjonkr)

括号

MCP（模型上下文协议）服务器，通过跟踪构建、发布、计算XP以及生成具有社交媒体主题级别的“内置公共”内容，使您的开发过程游戏化。

🎮 特性

• XP系统：从烧毁的代币、更改的线路和社交媒体帖子中获得XP
• 社交媒体级别：从潜伏者到传奇，以现实主义的进程崛起
• 邮局大门：级别提升需要公开发布您的进度
• 条纹奖金：获取连续建造天数的XP乘数
• 推特生成：使用级别上下文自动起草“内置公共”内容
• 简单存储：JSONL构建日志+JSON统计数据

📈 XP计算

• 每100个代币1 XP 在AI会话中被烧毁
• 每10行1 XP 提交更改
• 每条社交媒体帖子50 XP （鼓励公共建筑）
• 条纹乘数：连续建造天数高达2倍
• 更陡的曲线：需要等级²×75 XP（传说需要大约6个月的日常构建）

🏆 社交媒体主题级别

• 1-5: 🫥 潜伏者 -“没人。零追随者能量。”
• 6-10: 🌱 幼苗 -“第一次提交，第一次发布。萌芽。”
• 11-15: 🔨 制造者 -“实际上是在建造东西。人们会注意到。”
• 16-20: 📢 广播员 -“定期发布。追随者很少。”
• 21-25: 🔥 热拿 -“内容点击量不同。增长迅速。”
• 26-30: ⚡ 托运人 -“每周发货一次。现场已知。”
• 31-35: 🏗️ 建筑师 -“人们研究你的转发。”
• 36-40: 🎯 网红 -“你看到X造的东西了吗？”
• 41-45: 👑 思想领袖 -“行业对话。播客邀请。”
• 46-50: 🦄 独角兽 -“大家都知道你的名字。”
• 51+: 🌍 传说 -“改变了游戏。”

🚪 后门-建造和分享

你不能在不公开发布的情况下超越某些级别：

• 1-10级：无需发布（只需构建）
• 11-20级：需要 每级1个员额 解锁（共10个帖子）
• 21-30级：需要 每级2个员额 解锁（20多个帖子）
• 31级+：需要 每级3个员额 解锁

*为什么？* 因为最好的建筑师会分享他们的旅程。水平门鼓励在公共场所进行真实的建筑。

🚀 安装

1.安装MCP服务器

npm install -g bracker

或者克隆并在本地安装：

git clone 
cd bracker
npm install
npm link  # Makes 'bracker' available globally

2.添加到Claude代码配置

将此添加到您的 ~/.claude/settings.json 在...之下 mcpServers:

{
  "mcpServers": {
    "bracker": {
      "command": "bracker",
      "args": []
    }
  }
}

3.安装git挂钩（可选）

对于推送上的自动构建日志：

# In your project directory
cp /path/to/bracker/hooks/post-push.sh .git/hooks/post-push
chmod +x .git/hooks/post-push

或者使用安装程序脚本：

# From the bracker directory
./hooks/install-hook.sh /path/to/your/project

🔧 MCP工具

log_build

记录构建事件并计算XP。

参数：

• repo （字符串，必填）：存储库名称
• diff_summary （字符串，必填）：Git差异摘要
• commit_message （string，必填）：Git提交消息
• conversation_summary （string，可选）：构建/学习了什么
• tokens_used （数字，可选）：消耗的AI代币

退货：

• 获得的XP、总XP、当前级别和头衔
• 如果液位被堵塞，则张贴闸门警告
• 推特草稿与水平上下文

log_post

登录社交媒体帖子并获得XP。

参数：

• url （字符串，必填）：推特/帖子的URL
• platform （字符串，可选）：平台名称（默认：“twitter”）
• content （字符串，可选）：发布了什么

退货：

• 获得XP（每个帖子50 XP）
• 员额总数
• 当前级别和已解锁的任何级别
• 下一级所需职位

get_stats

获取当前构建统计数据和级别进度。

退货：

• 总经验值、级别和标题及描述
• 构建、发布和令牌总数
• 当前连胜和上次建造日期
• 门后状态（有门/无门）
• 解锁下一关卡所需的帖子

suggest_tweet

使用级别上下文从最近的构建中生成推文草稿。

参数：

• style （枚举，可选）： raw | polished | educational （默认值： raw)

退货：

• 推特草稿，包括当前级别
• 今天的构建和发布
• 登机口状态和张贴鼓励

📊 存储

数据存储在 ~/.bracker/:

• builds.jsonl：构建事件（每行一个JSON对象）
• stats.json：汇总统计

🔍 测试

测试MCP服务器：

echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | bracker

应归还可用工具。

🤖 使用Claude代码

配置后，Claude Code可以调用bracker工具：

记录构建：

Log this build: 
- Repo: my-app
- Changes: Added auth system, 150 lines
- Tokens used: 2500
- Commit: "feat: implement JWT authentication"

记录社交媒体帖子：

I just tweeted about my progress: https://twitter.com/user/status/123456789

获取当前统计数据：

What's my current level and progress?

生成推文：

Suggest a tweet about today's work (polished style)

Claude将跟踪您的构建、发布、计算XP、警告后门，并帮助您公开构建！

💡 专业提示

1. 会话文件：创建 .claude_session 在项目根目录中，使用对话摘要和令牌计数进行自动钩子检测
2. 多个仓库：每个repo都贡献给同一个XP池
3. Streak大楼：每天编码以获得最大XP乘数
4. 推特风格：为不同的受众使用不同的风格

🛠️ 发展

# Clone the repo
git clone 
cd bracker

# Install dependencies
npm install

# Test locally
npm test

# Make changes and test
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node index.js

📝 许可证

麻省理工学院-公开建设，分享成果！ 🚀