@vasperacapital/vaspera-mcp-server 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,182 @@
+# VasperaPM
+
+<div align="center">
+
+```
+╔═══════════════════════════════════════════════════════════════╗
+║                                                               ║
+║   ██╗   ██╗ █████╗ ███████╗██████╗ ███████╗██████╗  █████╗    ║
+║   ██║   ██║██╔══██╗██╔════╝██╔══██╗██╔════╝██╔══██╗██╔══██╗   ║
+║   ██║   ██║███████║███████╗██████╔╝█████╗  ██████╔╝███████║   ║
+║   ╚██╗ ██╔╝██╔══██║╚════██║██╔═══╝ ██╔══╝  ██╔══██╗██╔══██║   ║
+║    ╚████╔╝ ██║  ██║███████║██║     ███████╗██║  ██║██║  ██║   ║
+║     ╚═══╝  ╚═╝  ╚═╝╚══════╝╚═╝     ╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝   ║
+║                                                               ║
+║              AI-Powered Product Management                    ║
+║                                                               ║
+╚═══════════════════════════════════════════════════════════════╝
+```
+
+**Transform your ideas into production-ready specs with AI**
+
+[![npm version](https://img.shields.io/npm/v/@vasperacapital/vaspera-mcp-server.svg)](https://www.npmjs.com/package/@vasperacapital/vaspera-mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+</div>
+
+---
+
+## What is VasperaPM?
+
+VasperaPM is an MCP (Model Context Protocol) server that brings AI-powered product management tools directly into Claude Code. Generate PRDs, API specs, test cases, and sync with your favorite PM tools - all from your IDE.
+
+### Key Features
+
+- **Generate PRDs** - Create comprehensive Product Requirements Documents from context
+- **Infer from Code** - Analyze existing codebases to generate documentation
+- **Generate Code** - Turn PRDs into implementation code
+- **API Specs** - Auto-generate OpenAPI/Swagger specifications
+- **Test Cases** - Create detailed test plans and acceptance criteria
+- **PM Tool Sync** - Export to Jira, Linear, and GitHub
+
+---
+
+## Quick Start
+
+### 1. Install
+
+```bash
+npm install -g @vasperacapital/vaspera-mcp-server
+```
+
+### 2. Set Up
+
+```bash
+vasperapm install
+```
+
+This will:
+- Configure Claude Code to use VasperaPM
+- Set up your API key (optional for test mode)
+- Show you the available tools
+
+### 3. Restart Claude Code
+
+After installation, restart VSCode or Claude Code to load the MCP server.
+
+### 4. Start Using
+
+In Claude Code, try:
+- "Generate a PRD for a user authentication system"
+- "Analyze this codebase and create a PRD"
+- "Generate test cases for this feature"
+
+---
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `vasperapm install` | Configure VasperaPM with Claude Code |
+| `vasperapm connect` | Set up your API key and integrations |
+| `vasperapm status` | Check your current configuration |
+| `vasperapm serve` | Start the MCP server (used by Claude Code) |
+| `vasperapm help` | Show help message |
+
+---
+
+## Available Tools
+
+Once installed, these tools are available in Claude Code:
+
+### PRD Tools
+| Tool | Description |
+|------|-------------|
+| `generate_prd` | Generate a PRD from description and context |
+| `infer_prd_from_code` | Analyze code to generate a PRD |
+| `generate_code_from_prd` | Generate implementation from PRD |
+| `expand_prd_section` | Expand a specific section of a PRD |
+| `validate_prd` | Validate PRD completeness and quality |
+
+### Integration Tools
+| Tool | Description |
+|------|-------------|
+| `sync_jira` | Export PRD to Jira epics and stories |
+| `sync_linear` | Export PRD to Linear projects |
+| `sync_github` | Create GitHub issues from PRD |
+
+### Specification Tools
+| Tool | Description |
+|------|-------------|
+| `generate_api_spec` | Generate OpenAPI specification |
+| `generate_test_cases` | Create test plans and cases |
+| `generate_user_stories` | Create user stories from PRD |
+
+### Utility Tools
+| Tool | Description |
+|------|-------------|
+| `list_templates` | List available PRD templates |
+| `get_template` | Get a specific template |
+| `estimate_effort` | Estimate implementation effort |
+
+---
+
+## API Key
+
+### Free Tier (Test Mode)
+Run `vasperapm install` without an API key to use test mode. This provides:
+- 5 API calls per month
+- Basic tool access
+- Local storage only
+
+### Production Mode
+Get your API key at [vasperapm.com/dashboard](https://vasperapm.com/dashboard) for:
+- Higher rate limits
+- Full tool access
+- Cloud sync
+- Jira/Linear/GitHub integrations
+
+---
+
+## Configuration
+
+VasperaPM stores configuration in:
+- `~/.vasperapm/config.json` - Your API key and settings
+- `~/.claude/claude_desktop_config.json` - Claude Code integration
+
+---
+
+## Integrations
+
+Connect your PM tools at [vasperapm.com/dashboard/integrations](https://vasperapm.com/dashboard/integrations):
+
+- **Jira** - Sync PRDs to epics and stories
+- **Linear** - Export tasks to Linear projects
+- **GitHub** - Create issues and track progress
+
+---
+
+## Requirements
+
+- Node.js 20+
+- Claude Code (VSCode extension or CLI)
+
+---
+
+## Support
+
+- **Documentation**: [github.com/rcolkitt/VasperaPM](https://github.com/rcolkitt/VasperaPM)
+- **Issues**: [github.com/rcolkitt/VasperaPM/issues](https://github.com/rcolkitt/VasperaPM/issues)
+- **Dashboard**: [vasperapm.com/dashboard](https://vasperapm.com/dashboard)
+
+---
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+<div align="center">
+Made with by <a href="https://github.com/rcolkitt">@rcolkitt</a>
+</div>

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node