Command Palette

Search for a command to run...

UnylyUnyly
Весь каталог

Repoflow

БесплатноНе проверен

Publish Python/npm/Docker projects to GitHub, PyPI, npm and Docker Hub with generated CI — GUI + CLI.

GitHubEmbed

Описание

Publish Python/npm/Docker projects to GitHub, PyPI, npm and Docker Hub with generated CI — GUI + CLI.

README

一键自动化MCP发布平台 - 从本地项目到完整测试报告,3分钟搞定

License: MIT Python 3.8+


🎯 核心功能

🏭 一键生产线

选择项目文件夹 → 点击开始 → 3分钟后完成

✨ 自动完成

  • ✅ 智能检测 - 读取完整 README.md,检测项目信息和环境变量
  • ✅ 环境变量配置 - 自动检测并弹窗让用户填写配置说明
  • ✅ GitHub发布 - 创建仓库、推送代码
  • ✅ PyPI/NPM发布 - 自动触发CI/CD(PyPI 和 NPM 都支持完整 README)
  • ✅ 即梦 Logo - 基于完整 README 描述生成专业 Logo
  • ✅ EMCP注册 - 发布到EMCP平台(包含环境变量配置)
  • ✅ MCP测试 - 测试所有工具
  • ✅ Agent测试 - 创建Agent并测试
  • ✅ 对话测试 - SignalR自动化对话测试
  • ✅ 生成报告 - HTML报告 + CDN链接

🎨 流程可视化

  • 📊 树状步骤展示
  • 🎯 实时进度更新
  • 📋 详细日志输出
  • ⚠️ 智能错误处理

🚀 快速开始

📦 安装依赖

# 克隆项目
git clone https://github.com/BACH-AI-Tools/RepoFlow.git
cd RepoFlow

# 安装依赖
pip install -r requirements.txt

🎨 启动 GUI

🍎 Apple 风格界面(推荐,优雅简洁):

.\run-mcp-factory.bat

三个界面对比:

界面 视觉风格 特点 适用场景
Apple 风格界面 🍎⭐ 浅色主题 + Apple 设计语言
简洁优雅
留白设计
• 🎨 Apple 设计语言
• 浅色系配色 (#F5F5F7)
• 系统蓝强调色 (#007AFF)
• SF Pro 字体
• 白色卡片设计
• 干净的交互效果
• 完整的流程追踪
🔥 强烈推荐
追求简洁优雅
MCP 完整流程
Ultra 界面 深色主题 + 荧光色
Glassmorphism 毛玻璃
发光动画效果
• 2024设计趋势
• 荧光青/粉色系
• 发光按钮
• 流畅动画
追求炫酷视觉体验
(仅基础功能)
现代化界面 Material Design 3
浅色/紫色系
• 简洁美观
• 圆角卡片
• 悬停效果
基础发布功能

首次使用配置

  1. 点击 ⚙️ 设置
  2. 配置必要信息:
    • GitHub Token
    • EMCP账号(手机号,验证码自动生成)
    • Azure OpenAI(可选)
  3. 保存配置

日常使用

  1. 选择项目文件夹(自动检测信息)
  2. 点击"🏭 开始生产"
  3. 等待3-5分钟
  4. 完成!

📦 打包成 EXE

# 方法 1: 运行打包脚本(推荐)
.\build-exe.bat

# 方法 2: 直接运行
python build_exe.py

# 生成的文件在
dist\RepoFlow.exe

3. 配置 GitHub Token

第一次使用时:

  1. 点击 GUI 中的 "🔗 获取新 Token" 按钮
  2. 在打开的页面点击 "Generate token"
  3. 复制 token 并粘贴到 GUI 输入框
  4. 点击 "💾 保存"

4. 发布项目

  1. 选择项目文件夹 - 点击"浏览"选择你的项目
  2. 自动检测 - GUI 会自动检测项目类型和版本号
  3. 配置选项:
    • ✅ 默认勾选 "立即发布到 PyPI/NPM"
    • 📌 版本号自动填充(可修改)
  4. 点击发布 - 一键完成!

📦 包命名规范

RepoFlow 会自动为你的包添加统一前缀,避免命名冲突:

平台 包名格式 示例
PyPI bachai-{项目名} bachai-data-analysis-mcp
NPM @bachai/{项目名} @bachai/file-search-mcp

安装示例:

# Python
pip install bachai-your-project

# Node.js
npm install @bachai/your-project

🔐 组织 Secrets 配置(一次性)

在 GitHub 组织设置中配置以下 Secrets(根据项目类型):

访问:https://github.com/organizations/你的组织/settings/secrets/actions

项目类型 需要的 Secrets
Python PYPI_TOKEN
Node.js NPM_TOKEN
Docker DOCKERHUB_USERNAME + DOCKERHUB_TOKEN

配置一次,所有仓库通用! ✨

如何获取 Token?


🎯 工作流程

选择项目文件夹
    ↓
GUI 自动检测项目类型和版本号
    ↓
勾选"立即发布"(默认已勾选)
    ↓
点击"一键发布"
    ↓
✅ 扫描敏感信息
✅ 创建 GitHub 仓库
✅ 生成 CI/CD Pipeline
✅ 推送代码到 GitHub
✅ 自动创建并推送 Tag (v{版本号})
✅ 触发 GitHub Actions
✅ 自动发布到 PyPI/NPM
    ↓
完成!🎉

🔐 安全保护

GitHub 原生安全功能(推荐)✨

RepoFlow 创建的仓库会自动配置 GitHub 安全功能:

功能 说明 公开仓库 私有仓库
✅ Vulnerability Alerts 依赖漏洞警报 🆓 自动启用 🆓 自动启用
✅ Secret Scanning 检测敏感信息 🆓 免费 💰 需 Advanced Security
✅ Push Protection 阻止敏感推送 🆓 免费 💰 需 Advanced Security
✅ Branch Protection 分支保护规则 🆓 自动配置 🆓 自动配置

推荐:发布到公开仓库,免费享受所有安全功能! 🎁

本地检查

检查项 说明 不通过时
✅ README.md 必须包含 README 拒绝发布
📦 包名冲突 自动添加前缀 自动处理

为什么使用 GitHub 原生保护?

对比项 本地扫描 GitHub Push Protection
准确性 ❌ 误报较多 ✅ 高精度(GitHub 维护)
覆盖率 ❌ 有限模式 ✅ 200+ 种密钥类型
实时性 ❌ 可绕过 ✅ 强制执行
维护 ❌ 需要自己更新 ✅ GitHub 自动更新

推荐配置: 在组织中启用 GitHub Advanced Security,详见 安全设置指南


🛠️ 命令行使用(高级)

基础命令

# 配置
python repoflow.py config

# 自动检测并发布
python repoflow.py init --repo 仓库名 --pipeline auto

# 指定 Pipeline 发布
python repoflow.py init --repo 仓库名 --pipeline pypi

示例

# 发布 Python 项目到 PyPI
python repoflow.py init --repo my-python-package --pipeline pypi

# 发布 Node.js 项目到 NPM
python repoflow.py init --repo my-node-package --pipeline npm

# 发布 Docker 镜像
python repoflow.py init --repo my-app --pipeline docker

更多命令:

python repoflow.py --help

📁 核心文件

MCP工厂/
├── mcp_factory_gui.py ⭐          # 主程序
├── settings_window.py            # 设置窗口
├── repoflow.py                   # CLI版本
├── run-mcp-factory.bat          # 启动脚本
├── src/                          # 核心模块
│   ├── workflow_executor.py     # 工作流执行器
│   ├── unified_config_manager.py # 配置管理
│   ├── github_manager.py        # GitHub管理
│   ├── git_manager.py           # Git操作
│   ├── emcp_manager.py          # EMCP管理
│   ├── mcp_tester.py            # MCP测试
│   ├── agent_tester.py          # Agent测试
│   ├── signalr_chat_tester.py   # 对话测试
│   └── ... 更多模块
├── requirements.txt             # 依赖
└── README.md                    # 本文档

🎓 使用技巧

1. 版本号管理

遵循语义化版本规范:

  • 1.0.0 - 首次发布
  • 1.0.1 - Bug 修复
  • 1.1.0 - 新功能(兼容)
  • 2.0.0 - 重大更新(不兼容)

2. Tag 已存在怎么办?

如果 Tag 已存在,GUI 会提示你:

方案 1:修改版本号(推荐)

1.0.0 → 1.0.1

方案 2:删除旧 Tag

git tag -d v1.0.0
git push origin :refs/tags/v1.0.0

3. 发布失败排查

  1. 检查 Secrets - 确保在组织中配置了正确的 Token
  2. 检查包名 - PyPI/NPM 上包名必须唯一
  3. 查看 Actions - 访问 GitHub Actions 查看详细日志

❓ 常见问题

Q: 推送时弹出多次 Git 认证窗口?

A: 这是正常的,一次认证用于推送代码,一次用于推送 Tag。

Q: 如何更新已发布的包?

A: 修改版本号,然后重新发布即可:

1.0.0 → 1.0.1

Q: 支持哪些项目类型?

A:

  • ✅ Python (PyPI)
  • ✅ Node.js (NPM)
  • ✅ Docker
  • ✅ C# / .NET (NuGet) - 开发中

Q: 可以发布到私有仓库吗?

A: 可以!勾选"创建为私有仓库"选项即可。


🤝 贡献

欢迎提交 Issue 和 Pull Request!


📄 许可证

MIT License - 详见 LICENSE 文件


🔗 相关链接



📦 打包成可执行文件

快速打包

Windows:

# 双击运行
build-exe.bat

# 或使用 PowerShell
.\build-exe.ps1

macOS/Linux:

# 运行构建脚本
./build-exe.sh

生成的文件:

  • Windows: dist/RepoFlow.exe (~20 MB)
  • macOS: dist/RepoFlow (~25 MB)
  • Linux: dist/RepoFlow (~25 MB)

特点:

  • ✅ 独立可执行文件
  • ✅ 无需 Python 环境
  • ✅ 包含所有依赖

自动构建(GitHub Actions)

每次推送 tag 时自动构建三个平台的版本:

git tag -a v1.0.0 -m "Release v1.0.0"
git push origin v1.0.0

GitHub Actions 会自动:

  1. ✅ 构建 Windows/macOS/Linux 版本
  2. ✅ 创建 GitHub Release
  3. ✅ 上传所有平台的可执行文件

下载地址:

https://github.com/BACH-AI-Tools/RepoFlow/releases

分发给用户

只需要把对应平台的文件给用户:

Windows:

  • 发送 RepoFlow.exe
  • 用户双击运行

macOS/Linux:

  • 发送 RepoFlow
  • 用户运行:
    chmod +x RepoFlow
    ./RepoFlow
    

就这么简单! 🎉


📚 配置

  • 配置文件模板: config_template.json
  • 配置文件位置: ~/.repoflow/config.json
  • 技术文档: docs/emcpflow/

🔗 相关平台

RepoFlow

EMCPFlow


🤝 贡献指南

欢迎提交 Issue 和 Pull Request!

开发环境设置

# 克隆项目
git clone https://github.com/BACH-AI-Tools/RepoFlow.git
cd RepoFlow

# 创建虚拟环境(推荐)
python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或
.\venv\Scripts\activate  # Windows

# 安装开发依赖
pip install -r requirements.txt

代码结构

  • src/ - 核心模块(请保持模块化和可测试性)
  • tests/ - 测试文件(请为新功能添加测试)
  • docs/ - 文档(请更新相关文档)

🎉 更新日志

v3.0.0 - MCP工厂(2025-11-07)

  • ✅ 完整的自动化流程(GitHub → EMCP → 测试)
  • ✅ 流程化步骤展示
  • ✅ 详细日志输出
  • ✅ 真实执行所有功能

Made with ❤️ by BACH Studio (巴赫工作室)

from github.com/BACH-AI-Tools/repoflow

Установить Repoflow в Claude Desktop, Claude Code, Cursor

Рекомендуется · одна команда, все IDE
unyly install repoflow

Ставит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.

Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh

Или настроить вручную

Выполни в терминале:

claude mcp add repoflow -- uvx repoflow

Пошаговые гайды: как установить Repoflow

FAQ

Repoflow MCP бесплатный?

Да, Repoflow MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Repoflow?

Нет, Repoflow работает без API-ключей и переменных окружения.

Repoflow — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить Repoflow в Claude Desktop, Claude Code или Cursor?

Открой Repoflow на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Похожие MCP

Compare Repoflow with

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории development