Coding Standards MCP Server

This MCP server provides tools for accessing coding style guidelines and best practices for various technologies (Java, Python, React).

Prerequisites

• Python 3.8 or higher
• MCP package (pip install mcp)
• UV package manager (recommended)

Quick Start

1. Install the server in Claude:

mcp install server.py

1. Run in development mode:

mcp dev server.py

The MCP inspector will start on port 3000.

Available Tools

Style Guides

Access language-specific coding style guidelines: - Java: Clean code practices, naming conventions, code organization - Python: PEP 8 based guidelines, Pythonic code practices - React: Component structure, hooks usage, TypeScript integration

Best Practices

Access language-specific application best practices: - Java: Project structure, architecture, testing, security - Python: Project layout, dependency management, testing practices - React: Component patterns, state management, performance optimization

API Reference

1. java_style_guide: Get Java coding style guidelines
2. Returns: Markdown formatted style guide

3. Example: nortal_coding_standards_java_style_guide()

4. java_best_practices: Get Java application best practices

5. Returns: Markdown formatted best practices

6. Example: nortal_coding_standards_java_best_practices()

7. python_style_guide: Get Python coding style guidelines

8. Returns: Markdown formatted style guide

9. Example: nortal_coding_standards_python_style_guide()

10. python_best_practices: Get Python application best practices

11. Returns: Markdown formatted best practices

12. Example: nortal_coding_standards_python_best_practices()

13. react_best_practices: Get React application best practices

14. Returns: Markdown formatted best practices
15. Example: nortal_coding_standards_react_best_practices()

Configuration

MCP Client Configuration

Add this to your MCP client configuration file (e.g., ~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "nortal_coding_standards": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/absolute/path/to/coding-standards-mcp/server.py"
      ]
    }
  }
}

Replace /absolute/path/to/coding-standards-mcp/server.py with your actual server path.

License

This project is licensed under the MIT License - see the LICENSE file for details.