MCP server bridging specs (Linear / JIRA / GitHub Issues / Notion / Markdown / Figma) to tests, with bidirectional traceability and a spec-quality coach (AI 規格大師)
Project description
MK Spec Master
AI 規格大師 — specs in, scenarios out. Bidirectional traceability so you always know what's tested.
⚠️ Alpha — v0.1 MVP. 7 tools shipped (markdown_local + github_issues sources). Full design in
docs/prd.md. Next: Linear / JIRA adapters + coverage matrix in v0.2.
What this is
An MCP server that turns specs — Linear tickets, JIRA stories, GitHub Issues, Notion pages, Figma annotations, plain Markdown — into structured test scenarios, hands them to any test runner (via mk-qa-master or directly), and maintains a live spec ↔ test coverage matrix.
Sibling to mk-qa-master in the mk-* family of opinionated AI-QA MCPs.
Why this is missing from the ecosystem
| Tool | Lock-in | What we do differently |
|---|---|---|
| AWS Kiro | AWS IDE only, proprietary | MCP-native, multi-client, open source |
| Jama Connect MCP | $50k+/year, enterprise-only | SMB / indie / AI-native segment |
| GitHub Spec Kit | spec→code; runtime test coverage out of scope | We add runtime test coverage |
| testomat.io / JIRA MCPs | Single source (JIRA), SaaS lock | Multi-source, file-based index, no lock |
See docs/prd.md §4 for the full positioning.
Status
| Milestone | Target | Status |
|---|---|---|
| v0.1 (MVP — markdown_local + github_issues, 7 tools) | June 2026 | ✅ Shipped |
| v0.2 (Linear, JIRA, coverage matrix, spec-quality coach) | Aug 2026 | ⬜ |
| v0.3 (Notion, Figma, auto-link, optimization plan) | Oct 2026 | ⬜ |
| v1.0 (production-ready, docs, integration recipes) | Q4 2026 | ⬜ |
Quick design read
- Vision + problem:
docs/prd.md§1–2 - Competitive positioning:
docs/prd.md§4 - Tool surface:
docs/prd.md§8 - Walkthrough (end-to-end with mk-qa-master):
docs/prd.md§19
Related
- mk-qa-master — the QA loop sibling. Tests run via mk-qa-master; coverage tracked here.
License
MIT — see LICENSE.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mk_spec_master-0.1.0.tar.gz.
File metadata
- Download URL: mk_spec_master-0.1.0.tar.gz
- Upload date:
- Size: 26.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e3b149cc2613b46c9ee7f8f783006bb4372e3649d5b7ac2dc170d44027e65ae5
|
|
| MD5 |
3b01b4e533807f1733a6f9fd4cf50f36
|
|
| BLAKE2b-256 |
8509ad3fa9f04f868fefbde8dce3667c0f6a20a24b4ba5d988058ef1040c7aef
|
Provenance
The following attestation bundles were made for mk_spec_master-0.1.0.tar.gz:
Publisher:
publish.yml on kao273183/mk-spec-master
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mk_spec_master-0.1.0.tar.gz -
Subject digest:
e3b149cc2613b46c9ee7f8f783006bb4372e3649d5b7ac2dc170d44027e65ae5 - Sigstore transparency entry: 1548604110
- Sigstore integration time:
-
Permalink:
kao273183/mk-spec-master@823de1e078aa0abc0ed7a9d3945904074fdf8f4a -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/kao273183
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@823de1e078aa0abc0ed7a9d3945904074fdf8f4a -
Trigger Event:
release
-
Statement type:
File details
Details for the file mk_spec_master-0.1.0-py3-none-any.whl.
File metadata
- Download URL: mk_spec_master-0.1.0-py3-none-any.whl
- Upload date:
- Size: 19.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2db9994a1109df1c68356d205bbec97147ca0786501ed1643f045cee4bc845fe
|
|
| MD5 |
0a66918d757d43e93f058ae21e02e826
|
|
| BLAKE2b-256 |
675ab327b7d4484d048cf03feed30dd49faebdbf534a6bf37c94caa9028fd1f3
|
Provenance
The following attestation bundles were made for mk_spec_master-0.1.0-py3-none-any.whl:
Publisher:
publish.yml on kao273183/mk-spec-master
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mk_spec_master-0.1.0-py3-none-any.whl -
Subject digest:
2db9994a1109df1c68356d205bbec97147ca0786501ed1643f045cee4bc845fe - Sigstore transparency entry: 1548604134
- Sigstore integration time:
-
Permalink:
kao273183/mk-spec-master@823de1e078aa0abc0ed7a9d3945904074fdf8f4a -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/kao273183
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@823de1e078aa0abc0ed7a9d3945904074fdf8f4a -
Trigger Event:
release
-
Statement type: