Kyson MCP Agent Tools

Industrial-grade Git Workflow Agent Infrastructure based on the Model Context Protocol (MCP).

🚀 Overview

kyson-mcp-agent-tools is a high-reliability MCP server designed to empower AI agents with professional Git and GitHub management capabilities. Unlike simple command wrappers, this tool implements a strict L1-L2-L3 layered architecture to ensure all agentic actions are safe, validated, and compliant with project standards.

🏗 Architecture (L1-L2-L3 Model)

Based on the core principles defined in our ARCHITECTURE.md:

L1 (Adapters): Atomic wrappers around Git and GitHub CLI. They handle the "dirty work" of command execution.
L2 (Orchestrators): Stateful business logic (e.g., Commit Plans, Sync Guards). They ensure semantic correctness and provide safe transaction-like operations.
L3 (Cognition): High-level Prompts and Flow definitions that align the AI's reasoning with the tool's capabilities.

📦 Quick Start

For AI Users (via `uvx`)

The fastest way to use this tool in your MCP-compatible client (like Cursor or Claude CLI):

{
  "mcpServers": {
    "agent-tools": {
      "command": "uvx",
      "args": ["kyson-mcp-agent-tools"]
    }
  }
}

For Developers

# Clone the repository
git clone https://github.com/kyson-dev/agent-tools.git

# Set up environment
cd agent-tools
python3 -m venv .venv
source .venv/bin/activate

# Install in editable mode
pip install -e .

🛡 Cascading Rules System

This tool features a unique 3-level configuration system that allows for granular control over agent behavior:

Priority	Level	Path	Purpose
1 (Highest)	Project	`<repo_root>/.agent/configs/rules.yaml`	Per-project constraints (e.g., Mandatory Scopes).
2	User	`~/.agent/configs/rules.yaml`	User-wide global preferences.
3 (Lowest)	Internal	Inside package	Default sane fallback rules.

Example Rule Table (`rules.yaml`)

git:
  commit:
    # Forces scope in commit message: feat(auth): add login
    message_regex: "^(feat|fix|docs|refactor)\\([a-z0-9._\\-]+\\): .{1,72}$"
    subject_max_length: 72

🤖 Available Workflows

1. Smart Commit Flow

Action: Automatically stages changes, analyzes diffs, and synthesizes a professional commit message.
Constraint: Validates against rules.yaml before every commit.

2. Guarded Sync Flow

Action: Safely pulls and pushes changes.
Safety: Automatically detects protected branches (e.g., main) and prevents direct commits/rebases unless permitted.

3. Automated PR Flow

Action: Senses differences between branches, generates PR descriptions, and executes creation.
Merge: Supports semantic squash-merging and branch cleanup.

🌐 CI/CD & Distribution

This project is built for automated distribution:

Build System: PEP 517 compliant via pyproject.toml.
Auto-Publish: Simply push a tag (e.g., v0.1.0) to GitHub to trigger the PyPI release workflow.

📄 License

MIT License. Created by Kyson.

Metadata

Release files for kyson-mcp-agent-tools 0.1.30

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kyson-mcp-agent-tools 0.1.30
File	Size	Uploaded	Provenance
kyson_mcp_agent_tools-0.1.30.tar.gz	29.7 kB	Mar 23, 2026	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for kyson-mcp-agent-tools 0.1.30
File	Interpreter	ABI	Platform	Reset
kyson_mcp_agent_tools-0.1.30-py3-none-any.whl 37.4 kB Mar 23, 2026 Without provenance	Python 3	none	any	Details

Total release size: 67.1 kB

Release files / kyson_mcp_agent_tools-0.1.30.tar.gz

Download URL	kyson_mcp_agent_tools-0.1.30.tar.gz
Size	29.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`d4592a5eab7e402c3fc65b09ba271387e6330f00162554c540835336852a4e2a`
BLAKE2b-256 checksum How to use checksums	`ba0129c432b92a60d55b6e3c5a25251340a3b1927c01e32a03f2ad91f775d990`
Upload date	Mar 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Release files / kyson_mcp_agent_tools-0.1.30-py3-none-any.whl

Download URL	kyson_mcp_agent_tools-0.1.30-py3-none-any.whl
Size	37.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c889182676a879c551e64760709ac4e70385af8373a3b0f3a88bc9ea81be4774`
BLAKE2b-256 checksum How to use checksums	`82ba6a2ffd705a33feef1d0149f23d3c10c301983258d1f4625f0f46464c29ec`
Upload date	Mar 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Security for kyson-mcp-agent-tools 0.1.30

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.