Skip to content

Conversation

ulasbilgen
Copy link

Summary

This PR adds a complete MCP server implementation to the Claude Requirements Gathering System, providing an alternative to the existing slash commands while maintaining full backward compatibility.

🚀 New Features

  • MCP Server Implementation: Complete TypeScript/Node.js MCP server using the official MCP SDK
  • 6 MCP Tools: All original slash commands converted to MCP tools:
    • requirements-start - Begin new requirement gathering
    • requirements-status - Check progress and session state
    • requirements-current - View active requirement details
    • requirements-end - Complete/incomplete/delete session
    • requirements-list - Multi-requirement overview with status
    • requirements-remind - Workflow rules and best practices reminder
  • npm Distribution: Published as claude-code-requirements for easy installation
  • Dual Installation Options: Users can choose between slash commands or MCP server

🛠 Technical Implementation

  • File-based State Management: Uses same structure as original slash commands
  • TypeScript: Full type safety with proper error handling
  • MCP SDK Compliance: Uses official @modelcontextprotocol/sdk
  • npx Distribution: Easy installation via npx claude-code-requirements
  • Backward Compatibility: Existing requirement folders work seamlessly

📦 Installation

Users can now install via npm:

npx claude-code-requirements

And add to Claude Desktop config:

{
  "mcpServers": {
    "claude-code-requirements": {
      "command": "npx",
      "args": ["claude-code-requirements"]
    }
  }
}

✅ Testing

  • MCP server initializes correctly
  • All 6 tools register and function properly
  • File operations working with same workflow
  • npm package published and verified working
  • Backward compatibility with existing requirement folders maintained

📋 Files Added

  • src/index.ts - Main MCP server implementation (564 lines)
  • package.json - npm package configuration
  • tsconfig.json - TypeScript configuration
  • dist/ - Built JavaScript files for distribution
  • Updated documentation with dual installation options

This enhancement makes the requirements gathering system accessible to a broader audience while preserving the original slash command functionality for existing users.

🔗 npm Package

Published and working: https://www.npmjs.com/package/claude-code-requirements

🤖 Generated with Claude Code

Co-Authored-By: Claude [email protected]

ulasbilgen and others added 6 commits June 28, 2025 23:19
- Implement Node.js TypeScript MCP server with 6 tools
- Add npm package configuration for distribution
- Include built files for direct GitHub installation
- Update documentation with dual installation options
- Maintain backward compatibility with slash commands

🤖 Generated with Claude Code

Co-Authored-By: Claude <[email protected]>
- Remove complex GitHub direct install instructions
- Emphasize npm package installation as primary method
- Simplify user experience with working npm package

🤖 Generated with Claude Code

Co-Authored-By: Claude <[email protected]>
- No longer needed since using regular npm registry
- Cleanup for cleaner repository

🤖 Generated with Claude Code

Co-Authored-By: Claude <[email protected]>
- Add settings configuration for discovery and expert question counts (1-20 range)
- Implement MCP elicitation for interactive boolean questions with default handling
- Add requirements-settings tool to manage question counts
- Update requirements-start to use configurable settings
- Rewrite requirements-status with elicitation workflow
- Add question pool system with smart defaults and reasoning
- Store settings in requirements/.mcp-settings.json
- Fix default handling for "press Enter" behavior in MCP clients
- Version bump to 1.1.0

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- Simplified requirements-settings tool to be parameter-free
- Shows current values and asks for each setting separately
- Uses MCP elicitation with current values as defaults
- Press Enter to keep existing values, or type new number
- Clear feedback showing what changed vs unchanged
- Better range validation (1-20) with helpful descriptions
- Version bump to 1.2.0

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- Ensure requirements directory exists in loadSettings() before reading
- Fixes issue where settings command fails on fresh projects
- Version bump to 1.2.1

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
amittell added a commit to amittell/claude-code-requirements-builder that referenced this pull request Jun 29, 2025
amittell added a commit to amittell/claude-code-requirements-builder that referenced this pull request Jun 29, 2025
- Added complete MCP server implementation from PR rizethereum#2
- Added /synthesize command from PR rizethereum#3
- Resolved README.md conflicts by combining both features
- Updated package.json URLs for forked repository
- All functionality tested and working
@amittell amittell mentioned this pull request Jul 2, 2025
justi added a commit to justi/claude-code-requirements-builder that referenced this pull request Aug 12, 2025
…re-openai-api-with-gem

Integrate OpenAI sentence expansion
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant