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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: commit-message-ai-mcp
-Version: 1.0.2
+Version: 1.0.4
 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
@@ -34,3 +34,46 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.10
 Requires-Dist: mcp>=1.0.0
+Description-Content-Type: text/markdown
+
+[![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 → commit_message_ai_mcp-1.0.4}/pyproject.toml

@@ -3,7 +3,8 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 [project]
 name = "commit-message-ai-mcp"
-version = "1.0.2"
+version = "1.0.4"
+readme = "README.md"
 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 → commit_message_ai_mcp-1.0.4}/server.py

@@ -103,6 +103,28 @@ def generate_commit_message(changes_description: str, commit_type: str = "auto",
     When NOT to use:
         Not suitable for real-time production decision-making without
         human review of results.
+
+    Args:
+        changes_description (str): The changes description to analyze or process.
+        commit_type (str): The commit type to analyze or process.
+        scope (str): The scope to analyze or process.
+        breaking (bool): The breaking to analyze or process.
+        api_key (str): The api key to analyze or process.
+
+    Behavioral Transparency:
+        - Side Effects: This tool is read-only and produces no side effects. It does not modify
+          any external state, databases, or files. All output is computed in-memory and returned
+          directly to the caller.
+        - Authentication: No authentication required for basic usage. Pro/Enterprise tiers
+          require a valid MEOK API key passed via the MEOK_API_KEY environment variable.
+        - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are
+          included in responses (X-RateLimit-Remaining, X-RateLimit-Reset).
+        - Error Handling: Returns structured error objects with 'error' key on failure.
+          Never raises unhandled exceptions. Invalid inputs return descriptive validation errors.
+        - Idempotency: Fully idempotent — calling with the same inputs always produces the
+          same output. Safe to retry on timeout or transient failure.
+        - Data Privacy: No input data is stored, logged, or transmitted to external services.
+          All processing happens locally within the MCP server process.
     """
     allowed, msg, tier = check_access(api_key)
     if not allowed:
@@ -164,6 +186,25 @@ def analyze_diff(diff_text: str, api_key: str = "") -> str:
     When NOT to use:
         Not suitable for real-time production decision-making without
         human review of results.
+
+    Args:
+        diff_text (str): The diff text to analyze or process.
+        api_key (str): The api key to analyze or process.
+
+    Behavioral Transparency:
+        - Side Effects: This tool is read-only and produces no side effects. It does not modify
+          any external state, databases, or files. All output is computed in-memory and returned
+          directly to the caller.
+        - Authentication: No authentication required for basic usage. Pro/Enterprise tiers
+          require a valid MEOK API key passed via the MEOK_API_KEY environment variable.
+        - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are
+          included in responses (X-RateLimit-Remaining, X-RateLimit-Reset).
+        - Error Handling: Returns structured error objects with 'error' key on failure.
+          Never raises unhandled exceptions. Invalid inputs return descriptive validation errors.
+        - Idempotency: Fully idempotent — calling with the same inputs always produces the
+          same output. Safe to retry on timeout or transient failure.
+        - Data Privacy: No input data is stored, logged, or transmitted to external services.
+          All processing happens locally within the MCP server process.
     """
     allowed, msg, tier = check_access(api_key)
     if not allowed:
@@ -231,6 +272,25 @@ def suggest_type(description: str, api_key: str = "") -> str:
     When NOT to use:
         Not suitable for real-time production decision-making without
         human review of results.
+
+    Args:
+        description (str): The description to analyze or process.
+        api_key (str): The api key to analyze or process.
+
+    Behavioral Transparency:
+        - Side Effects: This tool is read-only and produces no side effects. It does not modify
+          any external state, databases, or files. All output is computed in-memory and returned
+          directly to the caller.
+        - Authentication: No authentication required for basic usage. Pro/Enterprise tiers
+          require a valid MEOK API key passed via the MEOK_API_KEY environment variable.
+        - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are
+          included in responses (X-RateLimit-Remaining, X-RateLimit-Reset).
+        - Error Handling: Returns structured error objects with 'error' key on failure.
+          Never raises unhandled exceptions. Invalid inputs return descriptive validation errors.
+        - Idempotency: Fully idempotent — calling with the same inputs always produces the
+          same output. Safe to retry on timeout or transient failure.
+        - Data Privacy: No input data is stored, logged, or transmitted to external services.
+          All processing happens locally within the MCP server process.
     """
     allowed, msg, tier = check_access(api_key)
     if not allowed:
@@ -287,6 +347,25 @@ def validate_conventional(message: str, api_key: str = "") -> str:
     When NOT to use:
         Not suitable for real-time production decision-making without
         human review of results.
+
+    Args:
+        message (str): The message to analyze or process.
+        api_key (str): The api key to analyze or process.
+
+    Behavioral Transparency:
+        - Side Effects: This tool is read-only and produces no side effects. It does not modify
+          any external state, databases, or files. All output is computed in-memory and returned
+          directly to the caller.
+        - Authentication: No authentication required for basic usage. Pro/Enterprise tiers
+          require a valid MEOK API key passed via the MEOK_API_KEY environment variable.
+        - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are
+          included in responses (X-RateLimit-Remaining, X-RateLimit-Reset).
+        - Error Handling: Returns structured error objects with 'error' key on failure.
+          Never raises unhandled exceptions. Invalid inputs return descriptive validation errors.
+        - Idempotency: Fully idempotent — calling with the same inputs always produces the
+          same output. Safe to retry on timeout or transient failure.
+        - Data Privacy: No input data is stored, logged, or transmitted to external services.
+          All processing happens locally within the MCP server process.
     """
     allowed, msg, tier = check_access(api_key)
     if not allowed: