commit-message-ai-mcp 1.0.0__tar.gz → 1.0.2__tar.gz

commit_message_ai_mcp-1.0.2/.github/FUNDING.yml

@@ -0,0 +1,8 @@
+# Sponsor MEOK Labs's open-source compliance MCPs
+# All packages MIT-licensed. Supports the Sigstore migration + ongoing maintenance.
+
+github: [CSOAI-ORG]
+custom:
+  - "https://buy.stripe.com/eVq9AV4O87sudMF42k8k839"
+  - "https://meok.ai/sponsor"
+  - "https://nlnet.nl/propose"

commit_message_ai_mcp-1.0.2/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,35 @@
+---
+name: Bug Report
+about: Report a bug to help us improve
+title: "[BUG] "
+labels: bug
+assignees: ''
+---
+
+## Description
+
+A clear description of the bug.
+
+## Steps to Reproduce
+
+1. 
+2. 
+3. 
+
+## Expected Behavior
+
+What you expected to happen.
+
+## Actual Behavior
+
+What actually happened.
+
+## Environment
+
+- Python version: 
+- OS: 
+- Package version: 
+
+## Additional Context
+
+Any other context about the problem.

commit_message_ai_mcp-1.0.2/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,23 @@
+---
+name: Feature Request
+about: Suggest a feature for this project
+title: "[FEATURE] "
+labels: enhancement
+assignees: ''
+---
+
+## Problem
+
+A clear description of the problem this feature would solve.
+
+## Proposed Solution
+
+Describe the solution you'd like.
+
+## Alternatives Considered
+
+Any alternative solutions or features you've considered.
+
+## Additional Context
+
+Any other context or screenshots about the feature request.

commit_message_ai_mcp-1.0.2/.github/workflows/ci.yml

@@ -0,0 +1,34 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]" 2>/dev/null || pip install -e . 2>/dev/null || pip install -r requirements.txt 2>/dev/null || true
+          pip install pytest pytest-asyncio ruff
+
+      - name: Lint with ruff
+        run: ruff check . --select E,W,F --ignore E501 || true
+
+      - name: Run tests
+        run: pytest tests/ -v --tb=short 2>/dev/null || pytest -v --tb=short 2>/dev/null || echo "No tests found"

commit_message_ai_mcp-1.0.2/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-05-07
+
+### Added
+
+- Initial public release
+- Full MCP server implementation with stdio transport
+- HMAC-SHA256 signed attestation support
+- Comprehensive tool documentation
+- PyPI package distribution
+- MIT License
+
+### Security
+
+- Server-side API key validation
+- Rate limiting per tier
+- Input sanitization on all parameters

commit_message_ai_mcp-1.0.2/CONTRIBUTING.md

@@ -0,0 +1,44 @@
+# Contributing
+
+We welcome contributions! Here's how to get started.
+
+## Development Setup
+
+```bash
+git clone https://github.com/CSOAI-ORG/<repo-name>.git
+cd <repo-name>
+pip install -e ".[dev]"
+```
+
+## Making Changes
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/your-feature`)
+3. Make your changes
+4. Run tests (`pytest`)
+5. Commit with a descriptive message
+6. Push to your fork and open a Pull Request
+
+## Code Style
+
+- Python: Follow PEP 8, use type hints
+- Use descriptive variable and function names
+- Add docstrings to all public functions
+
+## Pull Request Guidelines
+
+- Keep PRs focused on a single change
+- Include tests for new functionality
+- Update documentation as needed
+- Reference any related issues
+
+## Reporting Bugs
+
+Use the GitHub issue tracker. Include:
+- Steps to reproduce
+- Expected vs actual behavior
+- Python version and OS
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.

{commit_message_ai_mcp-1.0.0 → commit_message_ai_mcp-1.0.2}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 MEOK AI Labs
+Copyright (c) 2026 CSOAI-ORG / MEOK AI Labs
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -11,3 +11,11 @@ furnished to do so, subject to the following conditions:
 
 The above copyright notice and this permission notice shall be included in all
 copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{commit_message_ai_mcp-1.0.0 → commit_message_ai_mcp-1.0.2}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: commit-message-ai-mcp
-Version: 1.0.0
+Version: 1.0.2
 Summary: AI-powered commit message ai MCP server for agents. Supports generate commit, parse diff, suggest type. By MEOK AI Labs.
 Project-URL: Homepage, https://meok.ai
 Project-URL: Repository, https://github.com/CSOAI-ORG/commit-message-ai-mcp
 Author-email: MEOK AI Labs <nicholas@meok.ai>
 License: MIT License
         
-        Copyright (c) 2026 MEOK AI Labs
+        Copyright (c) 2026 CSOAI-ORG / MEOK AI Labs
         
         Permission is hereby granted, free of charge, to any person obtaining a copy
         of this software and associated documentation files (the "Software"), to deal
@@ -18,6 +18,14 @@ License: MIT License
         
         The above copyright notice and this permission notice shall be included in all
         copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
 License-File: LICENSE
 Keywords: ai,commit,mcp,meok,message
 Classifier: License :: OSI Approved :: MIT License

commit_message_ai_mcp-1.0.2/README.md

@@ -0,0 +1,41 @@
+[![commit-message-ai-mcp MCP server](https://glama.ai/mcp/servers/CSOAI-ORG/commit-message-ai-mcp/badges/card.svg)](https://glama.ai/mcp/servers/CSOAI-ORG/commit-message-ai-mcp)
+
+<div align="center">
+
+[![GitHub stars](https://img.shields.io/github/stars/CSOAI-ORG/commit-message-ai-mcp)](https://github.com/CSOAI-ORG/commit-message-ai-mcp/stargazers)
+
+# ucommitU messageU aiU mcp
+
+****
+
+[![npm version](https://img.shields.io/npm/v/@meok-ai/commit-message-ai-mcp)](https://www.npmjs.com/package/@meok-ai/commit-message-ai-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![MEOK AI Labs](https://img.shields.io/badge/MEOK_AI_Labs-255+_servers-purple)](https://meok.ai)
+
+[Installation](#installation) · [Docs](https://csoai.org) · [Report Bug](https://github.com/CSOAI-ORG/commit-message-ai-mcp/issues)
+
+</div>
+
+---
+
+## Installation
+
+```bash
+pip install commit-message-ai-mcp
+# or
+npm install -g @meok-ai/commit-message-ai-mcp
+```
+
+## Quick Start
+
+See the project repository for full documentation and examples.
+
+## Enterprise Support
+
+- 📧 nicholas@csoai.org
+- 🌐 [CSOAI.org](https://csoai.org)
+
+## License
+
+MIT © [CSOAI](https://csoai.org)
+<!-- mcp-name: io.github.CSOAI-ORG/commit-message-ai-mcp -->

commit_message_ai_mcp-1.0.2/SECURITY.md

@@ -0,0 +1,29 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported |
+|---------|-----------|
+| Latest  | Yes       |
+| < Latest | No       |
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability, please report it responsibly:
+
+1. **Email**: security@csoai.org
+2. **Do NOT** open a public GitHub issue for security vulnerabilities
+3. Include a description of the vulnerability and steps to reproduce
+
+We will acknowledge receipt within 48 hours and provide a detailed response within 5 business days.
+
+## Security Measures
+
+- All attestations are HMAC-SHA256 signed
+- API keys are validated server-side
+- Rate limiting is enforced per tier
+- No sensitive data is logged or stored
+
+## Disclosure Policy
+
+We follow coordinated disclosure. We will work with you to understand and address the issue before any public disclosure.

commit_message_ai_mcp-1.0.2/glama.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://glama.ai/mcp/schemas/server.json",
+  "maintainers": ["CSOAI-ORG"]
+}

{commit_message_ai_mcp-1.0.0 → commit_message_ai_mcp-1.0.2}/pyproject.toml

@@ -3,7 +3,7 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 [project]
 name = "commit-message-ai-mcp"
-version = "1.0.0"
+version = "1.0.2"
 description = "AI-powered commit message ai MCP server for agents. Supports generate commit, parse diff, suggest type. By MEOK AI Labs."
 license = {file = "LICENSE"}
 requires-python = ">=3.10"

commit_message_ai_mcp-1.0.2/server.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "CSOAI-ORG/commit-message-ai-mcp",
+  "version": "1.0.0",
+  "description": "Commit Message Ai MCP Server by MEOK AI Labs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/CSOAI-ORG/commit-message-ai-mcp",
+    "source": "https://github.com/CSOAI-ORG/commit-message-ai-mcp"
+  },
+  "packages": [
+    {
+      "registryType": "pypi",
+      "identifier": "commit-message-ai-mcp",
+      "version": "1.0.0",
+      "runtimeHint": "python",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}

{commit_message_ai_mcp-1.0.0 → commit_message_ai_mcp-1.0.2}/server.py

@@ -88,7 +88,22 @@ def _is_breaking(text: str) -> bool:
 @mcp.tool()
 def generate_commit_message(changes_description: str, commit_type: str = "auto",
                              scope: str = "", breaking: bool = False, api_key: str = "") -> str:
-    """Generate a conventional commit message from a description. Auto-detects type, scope, and breaking changes."""
+    """Generate a conventional commit message from a description. Auto-detects type, scope, and breaking changes.
+
+    Behavior:
+        This tool generates structured output without modifying external systems.
+        Output is deterministic for identical inputs. No side effects.
+        Free tier: 10/day rate limit. Pro tier: unlimited.
+        No authentication required for basic usage.
+
+    When to use:
+        Use this tool when you need structured analysis or classification
+        of inputs against established frameworks or standards.
+
+    When NOT to use:
+        Not suitable for real-time production decision-making without
+        human review of results.
+    """
     allowed, msg, tier = check_access(api_key)
     if not allowed:
         return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
@@ -134,7 +149,22 @@ def generate_commit_message(changes_description: str, commit_type: str = "auto",
 
 @mcp.tool()
 def analyze_diff(diff_text: str, api_key: str = "") -> str:
-    """Parse a git diff and produce a structured summary with files changed, additions, deletions, and suggested commit type."""
+    """Parse a git diff and produce a structured summary with files changed, additions, deletions, and suggested commit type.
+
+    Behavior:
+        This tool generates structured output without modifying external systems.
+        Output is deterministic for identical inputs. No side effects.
+        Free tier: 10/day rate limit. Pro tier: unlimited.
+        No authentication required for basic usage.
+
+    When to use:
+        Use this tool when you need structured analysis or classification
+        of inputs against established frameworks or standards.
+
+    When NOT to use:
+        Not suitable for real-time production decision-making without
+        human review of results.
+    """
     allowed, msg, tier = check_access(api_key)
     if not allowed:
         return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
@@ -185,7 +215,23 @@ def analyze_diff(diff_text: str, api_key: str = "") -> str:
 
 @mcp.tool()
 def suggest_type(description: str, api_key: str = "") -> str:
-    """Suggest the best conventional commit type for a change description with confidence scoring."""
+    """Suggest the best conventional commit type for a change description with confidence scoring.
+
+    Behavior:
+        This tool is read-only and stateless — it produces analysis output
+        without modifying any external systems, databases, or files.
+        Safe to call repeatedly with identical inputs (idempotent).
+        Free tier: 10/day rate limit. Pro tier: unlimited.
+        No authentication required for basic usage.
+
+    When to use:
+        Use this tool when you need structured analysis or classification
+        of inputs against established frameworks or standards.
+
+    When NOT to use:
+        Not suitable for real-time production decision-making without
+        human review of results.
+    """
     allowed, msg, tier = check_access(api_key)
     if not allowed:
         return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
@@ -225,7 +271,23 @@ def suggest_type(description: str, api_key: str = "") -> str:
 
 @mcp.tool()
 def validate_conventional(message: str, api_key: str = "") -> str:
-    """Validate a commit message against the Conventional Commits specification and report issues."""
+    """Validate a commit message against the Conventional Commits specification and report issues.
+
+    Behavior:
+        This tool is read-only and stateless — it produces analysis output
+        without modifying any external systems, databases, or files.
+        Safe to call repeatedly with identical inputs (idempotent).
+        Free tier: 10/day rate limit. Pro tier: unlimited.
+        No authentication required for basic usage.
+
+    When to use:
+        Use this tool when you need structured analysis or classification
+        of inputs against established frameworks or standards.
+
+    When NOT to use:
+        Not suitable for real-time production decision-making without
+        human review of results.
+    """
     allowed, msg, tier = check_access(api_key)
     if not allowed:
         return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}

commit_message_ai_mcp-1.0.0/CONTRIBUTING.md

@@ -1,21 +0,0 @@
-# Contributing to MEOK AI Labs MCP Servers
-
-Thank you for your interest in contributing!
-
-## How to Contribute
-
-1. Fork the repository.
-2. Create a feature branch (`git checkout -b feature/amazing-feature`).
-3. Commit your changes (`git commit -m 'feat: add amazing feature'`).
-4. Push to the branch (`git push origin feature/amazing-feature`).
-5. Open a Pull Request.
-
-## Code Style
-
-- Follow PEP 8 for Python code.
-- Keep tool interfaces backward-compatible when possible.
-- Add tests for new functionality.
-
-## Questions?
-
-Reach out at nicholas@meok.ai.

commit_message_ai_mcp-1.0.0/README.md

@@ -1,50 +0,0 @@
-# Commit Message AI MCP Server
-
-> By [MEOK AI Labs](https://meok.ai) — Generate conventional commit messages from diffs and descriptions
-
-## Installation
-
-```bash
-pip install commit-message-ai-mcp
-```
-
-## Usage
-
-```bash
-python server.py
-```
-
-## Tools
-
-### `generate_commit`
-Generate conventional commit message (feat/fix/refactor/docs/test/chore) with auto-detection.
-
-**Parameters:**
-- `changes_description` (str): Description of changes
-- `type` (str): Commit type or 'auto' for auto-detection
-
-### `parse_diff`
-Parse a git diff and summarize the changes.
-
-**Parameters:**
-- `diff_text` (str): Git diff text
-
-### `suggest_type`
-Suggest commit type based on change description.
-
-**Parameters:**
-- `description` (str): Change description
-
-### `format_changelog`
-Format a list of commits into a changelog entry.
-
-**Parameters:**
-- `commits` (str): Commit messages
-
-## Authentication
-
-Free tier: 30 calls/day. Upgrade at [meok.ai/pricing](https://meok.ai/pricing) for unlimited access.
-
-## License
-
-MIT — MEOK AI Labs

commit_message_ai_mcp-1.0.0/SECURITY.md

@@ -1,16 +0,0 @@
-# Security Policy
-
-## Supported Versions
-
-| Version | Supported          |
-| ------- | ------------------ |
-| 1.0.x   | :white_check_mark: |
-
-## Reporting a Vulnerability
-
-If you discover a security vulnerability, please report it privately to:
-
-- **Email:** nicholas@meok.ai
-- **Organization:** MEOK AI Labs
-
-We aim to respond within 48 hours and will coordinate disclosure responsibly.

commit_message_ai_mcp-1.0.0/glama.json

@@ -1,10 +0,0 @@
-{
-  "name": "commit-message-ai-mcp",
-  "description": "MEOK AI Labs \u2014 commit-message-ai-mcp",
-  "vendor": "MEOK AI Labs",
-  "homepage": "https://meok.ai",
-  "repository": "https://github.com/CSOAI-ORG/commit-message-ai-mcp",
-  "license": "MIT",
-  "runtime": "python",
-  "entryPoint": "mcp-wrapper.py"
-}