@leanspec/mcp

MCP server integration wrapper for LeanSpec

This package provides a simple entry point for using LeanSpec as an MCP (Model Context Protocol) server with AI assistants like Claude Desktop, Cline, and Zed.

Quick Start

Standard Configuration

Most MCP-compatible tools use this standard configuration format:

{
  "mcpServers": {
    "leanspec": {
      "command": "npx",
      "args": ["-y", "@leanspec/mcp"]
    }
  }
}

Supported Tools

Works with any tool supporting the Model Context Protocol, including:

AI Coding Assistants:

• VS Code (GitHub Copilot)
• Cursor
• Windsurf
• Amp

AI Chat Interfaces:

• Claude Desktop
• Claude Code
• Goose
• Kiro

Terminal & CLI:

• Warp
• Gemini CLI

Development Platforms:

• Factory
• Qodo Gen
• LM Studio
• And more!

Configuration File Locations

Claude Desktop

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

VS Code

• Add to your workspace or user settings.json
• Use github.copilot.chat.mcp.servers for GitHub Copilot

Other Tools

Refer to your tool's documentation for the configuration file location. Most use the standard MCP config format above.

What is MCP?

The Model Context Protocol (MCP) is an open protocol that standardizes how AI applications connect to data sources and tools. LeanSpec's MCP server lets AI assistants read and manage your project specifications directly.

Available Tools

The LeanSpec MCP server provides these tools to AI assistants:

• list - List all specifications with filtering
• view - Read complete specification content
• search - Search across specifications
• files - List files in a specification
• deps - Show dependency graphs
• board - View Kanban-style project board
• create - Create new specifications
• update - Update specification metadata
• archive - Archive completed specs
• tokens - Count tokens for context management
• stats - Get project statistics
• validate - Validate specification quality
• check - Check for sequence conflicts
• backfill - Backfill metadata from git history

How It Works

This package is a lightweight wrapper that delegates to the lean-spec mcp command. When you use npx @leanspec/mcp, it:

1. Automatically installs @leanspec/mcp and its lean-spec dependency
2. Runs lean-spec mcp to start the MCP server
3. Your IDE communicates with the server via stdio

No manual installation or setup required!

Requirements

• Node.js 20 or higher
• A LeanSpec project (specs directory with specifications)

Troubleshooting

Server not starting?

• Ensure Node.js 20+ is installed: node --version
• Check that you're in a directory with a specs/ folder
• Restart your IDE after updating the config

Changes not taking effect?

• Fully restart your IDE (not just reload)
• Clear npx cache: npx clear-npx-cache

Want to see debug logs?

• Check your IDE's MCP server logs
• Claude Desktop: View → Developer Tools → Console
• Cline: Check VS Code's Output panel

Documentation

For complete documentation, visit: https://lean-spec.dev

License

MIT