USD/Multi-Currency Feature - MCP Knowledge Server

Model Context Protocol (MCP) Server providing instant context about USD/Multi-Currency feature implementation across all microservices.

🎯 What is This?

This MCP server acts as a centralized knowledge base for the USD/Multi-Currency feature. Connect it to any AI coding assistant (Kiro, Claude, Cursor, etc.) to get instant, accurate answers about:

• Feature requirements and architecture
• API contracts and endpoints
• Code examples from actual implementation
• Troubleshooting guides
• Migration procedures
• Cross-service integration patterns

🚀 Quick Start (NPM - Recommended)

No installation needed! Just add to your AI tool's config:

For Kiro

Add to .kiro/settings/mcp.json:

{
  "mcpServers": {
    "usd-feature-knowledge": {
      "command": "npx",
      "args": ["usd-feature-mcp-server@latest"],
      "disabled": false,
      "autoApprove": [
        "get_feature_context",
        "get_code_example",
        "search_documentation",
        "get_troubleshooting",
        "get_migration_guide"
      ]
    }
  }
}

For Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "usd-feature-knowledge": {
      "command": "npx",
      "args": ["usd-feature-mcp-server@latest"]
    }
  }
}

For Cursor

Add to Cursor settings:

{
  "mcp.servers": {
    "usd-feature-knowledge": {
      "command": "npx",
      "args": ["usd-feature-mcp-server@latest"]
    }
  }
}

That's it! Restart your AI tool and start asking questions. npx automatically downloads and runs the latest version.

🔧 Alternative: Local Development Setup

If you want to modify the server or contribute:

1. Clone & Install

git clone https://github.com/YOUR_USERNAME/usd-feature-mcp-server.git
cd usd-feature-mcp-server
npm install

2. Build

npm run build

3. Connect to Your IDE

Use local path instead of npx:

{
  "mcpServers": {
    "usd-feature-knowledge": {
      "command": "node",
      "args": ["/absolute/path/to/usd-feature-mcp-server/dist/index.js"]
    }
  }
}

4. Restart Your IDE

The MCP server will now be available!

💡 How to Use

Once connected, ask your AI assistant questions like:

"Show me how to implement currency support in a new endpoint"

"Get the coupon validation code with country filtering"

"How do I handle MISSING_COUNTRY_DATA error?"

"What's the API contract for currency resolution?"

"Show me the migration guide for Reports API"

"Search the USD docs for exchange rate handling"

🛠️ Available Tools

The MCP server provides these tools:

1. get_feature_context

Get comprehensive context about the feature

• Parameters: section (overview | requirements | architecture | api-contracts | all)
• Example: "Get feature context for architecture"

2. get_code_example

Get actual code examples from production

• Parameters: component, language (backend | frontend)
• Components: currency-controller, coupon-validation, country-dropdown, etc.
• Example: "Get code example for coupon-validation in backend"

3. search_documentation

Search through all documentation

• Parameters: query (search keywords)
• Example: "Search documentation for validation errors"

4. get_troubleshooting

Get troubleshooting guides

• Parameters: issue (validation-errors | common-issues | testing-guide)
• Example: "Get troubleshooting for validation-errors"

5. get_migration_guide

Get migration guides for services

• Parameters: service (admin-api | reports-api | mobile-app | all)
• Example: "Get migration guide for reports-api"

6. get_implementation_summary

Get complete implementation summary

• Example: "Get implementation summary"

📚 Knowledge Base Structure

knowledge/
├── overview.md                    # Feature overview
├── requirements.md                # Detailed requirements
├── architecture.md                # System architecture
├── api-contracts.md               # API documentation
├── code-examples/
│   ├── backend/
│   │   ├── currency-controller.md
│   │   ├── coupon-validation.md
│   │   └── country-filtering.md
│   └── frontend/
│       ├── country-dropdown.md
│       ├── currency-display.md
│       └── coupon-form.md
├── migrations/
│   ├── admin-api.md
│   ├── reports-api.md
│   └── mobile-app.md
├── troubleshooting/
│   ├── validation-errors.md
│   ├── common-issues.md
│   └── testing-guide.md
└── updates/
    └── changelog.md

🔄 Updating Knowledge

Manual Update

1. Edit files in knowledge/ directory
2. Rebuild: npm run build
3. Restart your IDE's MCP connection

Automated Update (Recommended)

Set up a GitHub Action to auto-update when USD-related files change:

# .github/workflows/update-knowledge.yml
name: Update Knowledge Base
on:
  push:
    branches: [main, feat/USD-new]
    paths:
      - '**/*currency*'
      - '**/*coupon*'
jobs:
  update:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Update Knowledge
        run: |
          # Extract and update documentation
          npm run extract-knowledge
      - name: Commit
        run: |
          git add knowledge/
          git commit -m "docs: update knowledge base" || true
          git push

🧪 Testing

Test the MCP server locally:

npm test

Or manually:

npm run dev

Then send a test request:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_feature_context",
    "arguments": {
      "section": "overview"
    }
  }
}

📦 Project Structure

usd-feature-mcp-server/
├── src/
│   └── index.ts              # Main MCP server
├── knowledge/                # Knowledge base files
├── tests/                    # Test files
├── dist/                     # Compiled output
├── package.json
├── tsconfig.json
└── README.md

🤝 Team Collaboration

For New Team Members

1. Clone this repository
2. Run npm install && npm run build
3. Add to your IDE's MCP configuration
4. Start asking questions!

For Contributors

When you make changes to USD feature:

1. Update relevant files in knowledge/
2. Add code examples if implementing new patterns
3. Update knowledge/updates/changelog.md
4. Commit and push

🔐 Security

• No sensitive data (API keys, passwords) in knowledge base
• All code examples are sanitized
• Public repository safe for sharing

📝 License

MIT

👥 Maintainers

• Kutumbh Team

🆘 Support

For issues or questions:

1. Check troubleshooting guides in knowledge base
2. Search documentation using the MCP server
3. Contact team members

🎉 Benefits

• ✅ Instant Context: No more searching through repos
• ✅ Always Updated: Living documentation
• ✅ Consistent Patterns: Everyone follows same implementation
• ✅ Fast Onboarding: New developers get up to speed quickly
• ✅ Cross-Service: Understand how all services interact
• ✅ AI-Powered: Natural language queries

Made with ❤️ by Kutumbh Team