MCP Server Practices

Name: MCP Server Practices
Author: agentience

@agentience

代码仓库

关于 MCP Server Practices

暂无概览

#mcp-server #git-tools #development-practices

基本信息

分类

其他

许可证

MIT license

运行时

python

传输方式

stdio

发布者

agentience

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "practices_mcp_server": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCP Server Practices?

MCP Server Practices is a Model Context Protocol server that provides tools and resources for managing Git branches according to standardized conventions, with optional integration with Jira for fetching issue summaries and updating issue statuses.

How to use MCP Server Practices?

Install the package using uv, activate the virtual environment, and run the server with practices server. Use MCP tools such as validate_branch_name, create_branch, and get_branch_info, or invoke the CLI directly with commands like practices branch validate, practices branch create, and optional --update-jira or --fetch-jira flags.

Key features of MCP Server Practices

Validates branch names against a configured naming convention
Creates branches following feature/, bugfix/, hotfix/, release/, and docs/ formats
Fetches Jira issue summaries for use in branch names
Updates Jira issue status when creating branches
Provides both MCP tools and a CLI interface

Use cases of MCP Server Practices

Enforce standardized Git branch naming across a development team
Automate branch creation from Jira issues with correct prefixes
Quickly validate existing branch names against team conventions

FAQ from MCP Server Practices

What branch naming conventions are supported?

feature/PMS-123-brief-description (from develop), bugfix/PMS-123-brief-description (from develop), hotfix/1.0.1-brief-description (from main), release/1.1.0 (from develop), and docs/update-readme (from develop).

How do I install MCP Server Practices?

Clone the repository, create a virtual environment with uv venv, activate it, and run uv pip install -e .. If you encounter issues with the mcp-python-sdk dependency, you may need to install it separately.

What MCP tools does the server expose?

validate_branch_name, create_branch, and get_branch_info.

How does Jira integration work?

The server can fetch issue summaries to use in branch names and update issue status when creating branches, controlled by the --update-jira and --fetch-jira flags.