Kaybarax/Standards-Based-Development-MCP-Server

Standards-Based Development MCP Server

An MCP (Model Context Protocol) server that enforces Standards-Based Development (SBD) throughout the development lifecycle. This server provides tools for code formatting, linting, testing, Docker operations, security scanning, documentation generation, and image publishing.

Features

• Code Formatting: Format code using Prettier with configurable rules
• Code Linting: Lint code using project-specific tools (ESLint, Flake8, etc.)
• Testing: Execute test suites with coverage reporting
• Docker Operations: Build and run Docker containers
• Security Scanning: Perform SAST/SCA scans using Bandit and other tools
• Documentation: Auto-generate project documentation
• Publishing: Tag and push Docker images to registries

Installation

Using Docker (Recommended)

docker pull yourorg/standards-based-development-mcp

From Source

git clone https://github.com/yourorg/standards-based-development-mcp.git
cd standards-based-development-mcp
pip install -r requirements.txt

Usage

Running the Server

Docker

docker run -i yourorg/standards-based-development-mcp

Local Development

python src/server.py

Development with Hot Reload

docker-compose up sbd-mcp-dev

Available Tools

The server exposes the following MCP tools:

1. formatCode - Format code using Prettier
2. lintCode - Run project-specific linting
3. runTests - Execute test suites with coverage
4. dockerBuild - Build Docker images
5. dockerRun - Run containers in development mode
6. scanSecurity - Perform security scans
7. generateDocs - Generate project documentation
8. publishImage - Publish Docker images to registries

Example JSON-RPC Calls

Format Code

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "formatCode",
    "arguments": {
      "code": "const x=1;",
      "filePath": "example.js"
    }
  }
}

Run Tests

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 2,
  "params": {
    "name": "runTests",
    "arguments": {
      "types": ["unit", "integration"]
    }
  }
}

Development

Setup Development Environment

1. Clone the repository:

git clone https://github.com/yourorg/standards-based-development-mcp.git
cd standards-based-development-mcp

2. Install dependencies:

pip install -r requirements.txt
npm install -g prettier

3. Run tests:

pytest

4. Build Docker image:

docker build -t sbd-mcp .

Project Structure

standards-based-development-mcp/
├── Dockerfile
├── docker-compose.yml
├── .prettierrc
├── .prettierignore
├── pytest.ini
├── requirements.txt
├── src/
│   ├── server.py          # Main MCP server with all tools
│   └── tools/             # Future: modular tool implementations
├── tests/
│   ├── unit/              # Unit tests
│   ├── integration/       # Integration tests
│   └── e2e/              # End-to-end tests
├── .github/
│   └── workflows/
│       └── ci.yml         # CI/CD pipeline
└── README.md

Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature-name
3. Make your changes and add tests
4. Ensure all tests pass: pytest
5. Format code: prettier --write .
6. Commit your changes: git commit -am 'Add feature'
7. Push to the branch: git push origin feature-name
8. Create a Pull Request

CI/CD Pipeline

The project includes a comprehensive CI/CD pipeline that:

• Runs code formatting checks with Prettier
• Performs linting with Flake8
• Executes unit and integration tests
• Builds Docker images
• Runs end-to-end tests
• Publishes images to Docker Hub (on main branch)

Configuration

Prettier Configuration

The project uses a .prettierrc configuration for consistent code formatting:

{
  "printWidth": 120,
  "tabWidth": 2,
  "useTabs": false,
  "semi": true,
  "singleQuote": true,
  "trailingComma": "all"
}

Test Configuration

Tests are configured via pytest.ini with coverage reporting and multiple test types (unit, integration, e2e, regression).

Security

• Input validation and sanitization
• OWASP best practices
• Regular dependency updates
• Security scanning with Bandit
• Container security scanning

License

MIT License - see LICENSE file for details.

Support

For issues and questions:

• Create an issue on GitHub
• Check the documentation in the docs/ directory
• Review the CI/CD logs for troubleshooting