Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
제작자가 쓴 설명(영어 원문)
Quy trình theo wave giữa PO và AI: khung tài liệu, skill, scaffold, nâng cấp three-way merge.
이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.
이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.
쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.
필요한 것
어떤 앱을 쓰세요?
위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.
Claude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 이 내용을 붙여 넣으세요
{
"mcpServers": {
"shipfast": {
"command": "uvx",
"args": [
"shipfast-mcp"
]
}
}
}터미널에서 이 명령어를 실행하세요
claude mcp add shipfast -- uvx shipfast-mcp프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요
{
"mcpServers": {
"shipfast": {
"command": "uvx",
"args": [
"shipfast-mcp"
]
}
}
}브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.
프로젝트의 .vscode/mcp.json에 붙여 넣으세요
{
"servers": {
"shipfast": {
"type": "stdio",
"command": "uvx",
"args": [
"shipfast-mcp"
]
}
}
}브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.
이 서버는 내 컴퓨터에서 실행되는데, ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.
선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.
이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.
내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.
누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 8일 점검
레지스트리 이름이 GitHub 계정 QuocTang 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요
레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.
해당하는 기본 점검 1개 중 1개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.
레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.
내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).
GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(0.2.3)은 24일 전 레지스트리에 올라왔어요.
Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Python (uv)도 있어야 해요.
같은 카테고리에는: Spec Driven Development, Remote Desktop Commander, Tethered Trust
같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.
카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Fit, compatibility and recall checks for AI agents before they buy: verdicts, evidence, receipts.
제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.
shipfast-mcp
Quy trình làm việc giữa PO và AI, đóng gói thành MCP server. PO quyết định phạm vi và nghiệm thu. Orchestrator điều phối, đề xuất và phản biện. Việc chuyên môn do các bộ phận lập theo dự án đảm nhận, mỗi bộ phận là một subagent.
Trang giới thiệu · PyPI · Tài liệu · Ghi chú phát hành
A Model Context Protocol server that brings a wave-based working process between a product owner and AI agents to any stack: an orchestrator that coordinates and critiques, project-specific departments as subagents, a single decision log, verified quality gates, and three-way-merge upgrades.
Cần uv.
| # | Bước | Lệnh | |
|---|---|---|---|
| 1 | Cài uv | `curl -LsSf https://astral.sh/uv/install.sh \ | sh` |
| 2 | Thêm shipfast vào Claude Code | /plugin install shipfast --marketplace QuocTang/shipfast-mcp | |
| 3 | Gọi prompt init (repo mới) hoặc adopt (dự án đang có code) | /mcp__shipfast__init | |
| 4 | Trả lời theo mã vấn đề | W01-02: A; nói "chốt" khi đồng ý phạm vi | |
| 5 | Nâng cấp khi có bản mới | /mcp__shipfast__upgrade |
Một phiên init trong Claude Code (rút gọn):
> /mcp__shipfast__init
● shipfast - scaffold_project (MCP)(mode: "init", dry_run: true) └ 34 file sẽ tạo, 0 file trùng
● Đã mở wave W01. Sản phẩm làm gì, cho ai dùng?
App quản lý kho cho cửa hàng nhỏ, hai vai: chủ cửa hàng và nhân viên.
● W01-01: nhập xuất kho, cảnh báo sắp hết, báo cáo tồn; in hoá đơn và đa chi nhánh để sau (BL-005, BL-006). W01-02 stack: đề xuất A (Next.js + Postgres). Phản biện: cần thêm runtime khi có job nền. W01-09: lập ba bộ phận PRODUCT, PLATFORM, TRUST.
W01-02: A, còn lại theo đề xuất. Chốt.
● shipfast - create_department (MCP)(code: "PLATFORM") └ docs/departments/platform/, .claude/agents/dept-platform.md
| Công cụ | Cách cài |
|---|---|
| Claude Code (plugin) | /plugin install shipfast --marketplace QuocTang/shipfast-mcp |
| Claude Code (MCP) | claude mcp add shipfast -- uvx shipfast-mcp |
| Cursor, VS Code, Codex và client MCP khác | Server stdio, lệnh uvx, tham số shipfast-mcp |
Cấu hình dạng JSON cho client đọc mcpServers:
{
"mcpServers": { "shipfast": { "command": "uvx", "args": ["shipfast-mcp"] } } }
Ghim phiên bản: uvx shipfast-mcp@0.2.2.
📥 Intake → 🗣️ Discussion → ✅ Scope lock → 🔨 Build → 🧹 Cleanup → 🧪 Acceptance → 🚀 Release
| Bước | Việc |
|---|---|
| Intake | Gom việc, mỗi vấn đề kèm phương án |
| Discussion | Orchestrator đề xuất và phản biện, lấy ý kiến bộ phận; PO chốt |
| Scope lock | PO nói "chốt"; phạm vi đóng băng, đổi qua CR |
| Build | Bộ phận phụ trách build theo hạng mục |
| Cleanup | Dọn mã chết, tài liệu lệch |
| Acceptance | QA độc lập với bộ phận đã build; quality gate chạy thật |
| Release | Phát hành, rút kinh nghiệm, đóng wave |
| Chế độ chốt | Khi nào |
|---|---|
| PO chốt | Mặc định |
| Chốt thẳng | Wave nhỏ, yêu cầu đã rõ |
| Delegation | PO giao quyền chốt cho debate giữa các bộ phận; Orchestrator làm Chủ toạ |
| Loại | Tên | Việc |
|---|---|---|
| 🔧 Tool | scaffold_project | Dựng CLAUDE.md, docs/ (wave, backlog, decision log, tổ chức) và skill .claude/skills/shipfast-*; dry run trước, không ghi đè |
| 🔧 Tool | upgrade | Nâng khung lên phiên bản mới bằng three-way merge |
| 🔧 Tool | status, check | Wave nào đang chạy, chờ PO điều gì; hồ sơ có lệch không |
| 🔧 Tool | refresh_departments | Làm mới file subagent bộ phận theo mẫu mới sau khi nâng cấp |
| 🔧 Tool | create_department | Lập bộ phận theo dự án: hồ sơ docs/departments/ /, subagent .claude/agents/dept- .md |
| 🔧 Tool | open_wave, new_decision, next_code | Mở wave, ghi quyết định, cấp mã không trùng |
| 🔧 Tool | read_guide | Tài liệu hướng dẫn cho người |
| 💬 Prompt | init, adopt, upgrade | Điểm vào |
| 📚 Resource | skill://shipfast-*/SKILL.md | 6 skill: luật nền, khởi tạo, áp dụng, chạy wave, debate, nâng cấp |
| 📚 Resource | shipfast://guide/* | Bắt đầu, tổ chức, ý nghĩa, phát triển và nâng cấp |
Dự án giữ .shipfast/manifest.json và .shipfast/base/ (bản khung lần trước). upgrade so ba bản: bản gốc, bản dự án, bản mới.
| Trường hợp | Kết quả |
|---|---|
| Dự án chưa sửa file | Thay bằng bản mới |
| Hai bên sửa khác chỗ | Gộp tự động |
| Hai bên sửa cùng chỗ | File thật giữ nguyên; bản gộp có dấu xung đột ở .shipfast/pending/ để duyệt |
| Bảng wave, backlog, decision log | Giữ nguyên |
| Bài | File |
|---|---|
| Bắt đầu từ đâu | start.md |
| Tổ chức ra sao | organization.md |
| Ý nghĩa và mục đích | purpose.md |
| Phát triển tiếp và nâng cấp | evolve.md |
| Ghi chú phát hành | changelog.md |
Đóng góp nên là cách làm đã chạy ở dự án thật và dùng được cho mọi stack.
Phát triển tại máy:
uv sync
uv run pytest uv run shipfast-mcp
Kho tri thức nằm ở src/shipfast_mcp/knowledge/: project/ (khung dựng vào dự án), department/ (hồ sơ và subagent bộ phận), skills/, guide/. Landing page ở site/ (site/README.md). Quyết định thiết kế: docs/decisions/README.md.
Made with contrib.rocks.
MIT License. See LICENSE for details.