MCP Spec Generator (docs)
Minimal notes for running and developing the MCP spec-generator tool described in this repo.
Requirements
- Node.js LTS (>=18)
- Environment variable:
ANTHROPIC_API_KEY
(store securely)
Quick notes
- The server communicates with Anthropic's
claude-4-sonnet-20240620
model. Keep temperature at0.0
for deterministic output. - Do not run with write permissions in production: MCP tools should return
create_file
/edit_file
calls for user approval in Cursor. - Example
.cursor/mcp.json
is provided in the repo as a template. When configuring, whitelist only the project folder.
Testing
- There are fixtures in
tests/fixtures/
to validate the expected Markdown outputs from the model.
How to run
- Run tests:
node tests/run_tests.js
ornpm test
. - Dry-run (propose files):
node index.js "My project idea..."
- Persist files:
node index.js "My project idea..." --allow-write
- Read prompt from stdin:
echo "My idea" | node index.js
Linting & formatting
- ESLint and Prettier configs are included. To lint/format locally run:
npm run lint
npm run format
Environment & setup (required)
- Set your Anthropic API key in the environment before running the tool:
- Linux/macOS:
export ANTHROPIC_API_KEY=sk-...
- Windows (PowerShell):
setx ANTHROPIC_API_KEY "sk-..."
- Linux/macOS:
- Optionally copy
env.example
to.env
or export additional overrides likeMCP_AUDIT_FILE
orANTHROPIC_TIMEOUT_MS
. - Make the CLI executable if you prefer:
chmod +x index.js
Cursor MCP configuration
- The repo includes
.cursor/mcp.json
configured to whitelist the project path. Verify it points to your repository root before registering with Cursor.
Security
- Never point the Filesystem MCP server at
~
or your home directory. Whitelist only the necessary project paths.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Generates project specifications and file structures using Claude AI through MCP integration. Enables users to describe project ideas and automatically create corresponding documentation and project files.
Related MCP Servers
- -securityAlicense-qualityAI-powered MCP server that enables Claude and other LLMs to interact directly with construction documents, drawings, and specifications through advanced RAG and hybrid search capabilities.Last updated -3TypeScriptMIT License
- -securityFlicense-qualityA comprehensive, domain-agnostic documentation scraping and AI integration toolkit. Scrape any documentation website, create structured databases, and integrate with Claude Desktop via MCP (Model Context Protocol) for seamless AI-powered documentation assistance.Last updated -5Python
- -securityAlicense-qualityAn MCP server that automatically manages and organizes project documentation using the document reference pattern, keeping CLAUDE.md files clean and under 500 lines while maintaining full context for AI assistants.Last updated -PythonMIT License
- AsecurityAlicenseAqualityConnects Blender to Claude AI through the Model Context Protocol (MCP), enabling prompt-assisted 3D modeling, scene creation, and manipulation.Last updated -17PythonMIT License