TypeScript MCP server

A Model Context Protocol server in TypeScript on the official v2 SDK, served over stdio, with zod-described tools, tool errors written for the model, JSON logs kept off stdout, and Vitest tests that connect a real MCP client in memory and to the server process.

What done means

Your agent follows the brief, then runs stacks verify without weakening or skipping checks. What happens next

Declared steps: install, lint, typecheck, test, stdio, build, smoke, readme-filled. View commands

Use this stack

Paste the prompt into the coding agent working on your project.

Full projectQuick local experiment

Uses the stack’s default fragments. Review the brief with your agent.Uses stated defaults and omits deploy, release, and app fragments unless explicitly requested.

View prompt

Use the typescript-mcp stack for this project. 1. Run npx @steamfield/stacks show typescript-mcp --json and check that it fits the project. If it does not, explain why before changing files. 2. Run npx @steamfield/stacks new typescript-mcp and follow the brief it prints. 3. From the generated project directory, run npx @steamfield/stacks verify. Fix failures without weakening or skipping verification steps. 4. Summarize what changed and the verification result. Quote published stats only when they are available, including their interval and sample size. The stacks docs, written for agents, are at https://stacks.steamfield.io/llms.txt.

Use the typescript-mcp stack for a quick local experiment. 1. Run npx @steamfield/stacks show typescript-mcp --json and check that it fits the project. If it does not, explain why before changing files. 2. Run npx @steamfield/stacks new typescript-mcp --sandbox and follow the brief it prints. 3. From the generated project directory, run npx @steamfield/stacks verify. Fix failures without weakening or skipping verification steps. 4. Summarize what changed and the verification result. Quote published stats only when they are available, including their interval and sample size. The stacks docs, written for agents, are at https://stacks.steamfield.io/llms.txt.

Or use the terminal

npx @steamfield/stacks new typescript-mcp

npx @steamfield/stacks new typescript-mcp --sandbox

Verify steps
Step	Phase	Layer	Command
install	setup	install	`bun install`
lint	check	lint	`bun run lint`
typecheck	check	typecheck	`bun run typecheck`
test	check	test	`bun run coverage`
stdio	check	test	`bun run test tests/stdio.test.ts`
build	check	build	`bun run build`
smoke	check	test	`bun run smoke`
readme-filled	check	check	`test -s README.md && ! grep -n 'stacks:fill' README.md`

Required fragments

claude-harness

Default fragments

Optional fragments

Dependencies
Role	Packages
app	@modelcontextprotocol/server, zod, pino
dev	@modelcontextprotocol/client, @modelcontextprotocol/inspector, typescript, @types/node, @biomejs/biome, vitest, @vitest/coverage-v8

Tools

bun · node · git

Usage and outcomes

Usage over time

Showing 180 days of history.

History

The 28-day green rate at each weekly observation. Gaps mean the sample was too small to publish.

Shaded band: 95% Wilson interval. Dashed rules: content changes. Missing observations remain gaps.

Stacks projects · 28 days through 4 Nov 2026. Counts rounded to 5.

Data table

Through	Green rate	Projects	Content change
5 Jul 2026	hidden: too few projects	–	–
12 Jul 2026	hidden: too few projects	620	–
19 Jul 2026	hidden: too few projects	1,340	–
26 Jul 2026	hidden: too few projects	2,390	–
2 Aug 2026	hidden: too few projects	3,580	–
9 Aug 2026	hidden: too few projects	4,250	–
16 Aug 2026	hidden: too few projects	4,855	–
23 Aug 2026	hidden: too few projects	5,395	–
30 Aug 2026	hidden: too few projects	5,740	–
6 Sept 2026	hidden: too few projects	6,140	–
13 Sept 2026	hidden: too few projects	6,625	–
20 Sept 2026	hidden: too few projects	6,930	–
27 Sept 2026	hidden: too few projects	7,280	–
4 Oct 2026	hidden: too few projects	7,610	–
11 Oct 2026	hidden: too few projects	7,855	–
18 Oct 2026	hidden: too few projects	8,255	–
25 Oct 2026	hidden: too few projects	8,785	–
1 Nov 2026	hidden: too few projects	9,075	–

Weekly projects by preset

Non-overlapping seven-day project counts, grouped by the preset used to start the project.

default
sandbox

Stacks projects per UTC week through 4 Nov 2026. Published preset counts only; hidden cells are not zero.

Data table

Week ending	Preset	Projects
5 Jul 2026	default	–
12 Jul 2026	default	410
19 Jul 2026	default	480
26 Jul 2026	default	680
2 Aug 2026	default	770
9 Aug 2026	default	830
16 Aug 2026	default	860
23 Aug 2026	default	1,050
30 Aug 2026	default	960
6 Sept 2026	default	1,105
13 Sept 2026	default	1,180
20 Sept 2026	default	1,190
27 Sept 2026	default	1,220
4 Oct 2026	default	1,310
11 Oct 2026	default	1,330
18 Oct 2026	default	1,470
25 Oct 2026	default	1,605
1 Nov 2026	default	1,485
5 Jul 2026	sandbox	–
12 Jul 2026	sandbox	210
19 Jul 2026	sandbox	240
26 Jul 2026	sandbox	370
2 Aug 2026	sandbox	420
9 Aug 2026	sandbox	460
16 Aug 2026	sandbox	465
23 Aug 2026	sandbox	540
30 Aug 2026	sandbox	575
6 Sept 2026	sandbox	585
13 Sept 2026	sandbox	635
20 Sept 2026	sandbox	700
27 Sept 2026	sandbox	670
4 Oct 2026	sandbox	710
11 Oct 2026	sandbox	730
18 Oct 2026	sandbox	820
25 Oct 2026	sandbox	815
1 Nov 2026	sandbox	820

By preset

Green verify outcomes by the preset chosen at scaffold time.

Not enough runs in this breakdown yet.

Stacks projects · 28 days through 4 Nov 2026. Counts rounded to 5.

By agent

Within this stack, listed alphabetically. These are project outcomes, not an agent ranking.

Not enough runs in this breakdown yet.

Stacks projects · 28 days through 4 Nov 2026. Counts rounded to 5.

Time to green

Published time summaries on a shared minutes scale. First passing test is a median; 75% reached green by the 75th percentile.

Median to green: –
75th percentile: –
First passing test: –
Verify runs to green: –

Stacks projects · 28 days through 4 Nov 2026. Counts rounded to 5.

Data table

Measure	Time / runs
Median to green	–
75th percentile	–
First passing test	–
Verify runs to green	–

Where it breaks

A run can fail more than one step. Environment failures are shown separately.

Environment blockedhidden: too few projects

Share of failed runs before first green. Environment blocked describes the machine, not the stack.

Data table

Step	Share
Environment blocked	–

What people change

Defaults people keep, and optional fragments they choose to attach.

Default, kept rate

claude-harness100%

git-hooks91%

ci-github92%

Optional, attach rate

rr17%

ce-plugin17%

Share of the window's 8,445 projects. Kept rate is 1 minus the without rate.

Data table

Fragment	Measure	Share
claude-harness	Kept	100%
git-hooks	Kept	91%
ci-github	Kept	92%
rr	Attached	17%
ce-plugin	Attached	17%

By composition 16 fingerprints

Each row is a distinct fragment composition, with its own sample and content history.

Composition	Green rate	Seen	Change in life
defaults + ce-plugin + rr − ci-github − git-hooks · 0eec8391	hidden: too few projects	16 Aug 2026 – 1 Nov 2026	None
defaults + rr · 15db358f	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + ce-plugin + rr · 1a01fdee	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + rr − ci-github − git-hooks · 485c9d5b	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + rr − git-hooks · 490f19f0	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults − git-hooks · 57acc984	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + ce-plugin + rr − ci-github · 6276fbe6	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults − ci-github − git-hooks · 6de3b7ca	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults · 6e83a8e4	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults − ci-github · 705cd3fe	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + ce-plugin + rr − git-hooks · 77b5485e	hidden: too few projects	19 Jul 2026 – 1 Nov 2026	None
defaults + ce-plugin − ci-github · 854e8bb2	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + ce-plugin − ci-github − git-hooks · 98f4ab74	hidden: too few projects	26 Jul 2026 – 1 Nov 2026	None
defaults + rr − ci-github · a3ba0010	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + ce-plugin − git-hooks · ba6753cd	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None
defaults + ce-plugin · e3ecf5c1	hidden: too few projects	12 Jul 2026 – 1 Nov 2026	None

Computed 5 Nov 2026, through 4 Nov 2026. Numbers describe stacks projects, not the ecosystem.