A Model Context Protocol server that exposes seed4j — an open source application generator — to MCP clients, AI coding assistants, and custom agent hosts.
Instead of a human driving seed4j directly, any MCP-aware client or assistant (Codex, Claude Code, Claude Desktop, Cursor, custom IDE integrations, autonomous agents, …) can call the tools below to discover modules, plan a stack, and scaffold a project.
This repo is a side project of seed4j, deliberately kept out of the main seed4j repository. The server talks to a running seed4j instance over HTTP — it does not embed seed4j as a library.
You'll need Node.js 20+ and a running seed4j instance (default http://localhost:1339). The server is published on npm as seed4j-mcp; the recommended entrypoint is npx:
# Codex
codex mcp add seed4j -- npx -y seed4j-mcp
# Claude Code (project scope, shared via .mcp.json)
claude mcp add seed4j --scope project -- npx -y seed4j-mcp
# Any other MCP client (JSON config)
# {
# "mcpServers": {
# "seed4j": { "command": "npx", "args": ["-y", "seed4j-mcp"] }
# }
# }Detailed setup per client (scopes, custom SEED4J_BASE_URL, global install) lives in docs/clients.md.
Start with docs/getting-started.md if you want to connect the server, verify seed4j is reachable, and run a first tool call.
All documentation lives under docs/:
- docs/README.md — documentation entry point with user, operator, and contributor reading paths.
- docs/getting-started.md — install, connect, verify, and try a first MCP flow.
- docs/overview.md — what the server is, the layers, the STDIO runtime contract.
- docs/tools.md — every MCP tool exposed today, with inputs/outputs and when to use it.
- docs/resources.md — read-only MCP resources for the catalogue (modules, landscape, presets).
- docs/prompts.md — MCP prompts that encode the curated-stack and custom-stack flows.
- docs/clients.md — wiring the server into Codex, Claude Code, Claude Desktop, Cursor, IDE integrations, and custom MCP hosts.
- docs/configuration.md — environment variables and their defaults.
- docs/errors.md — how failures surface to MCP clients and agents.
- docs/logging.md — opt-in JSONL debug log (
SEED4J_LOG_FILE). - docs/seed4j-api.md — verified seed4j HTTP contract.
- docs/develop.md — local dev setup, tests, STDIO caveat.
- docs/changelog.md — what shipped, per roadmap item.
- docs/ROADMAP.md — planned improvements.
Apache License 2.0 — see LICENSE.