🚀 MCP 服务器实践规范

MCP 服务器是一个基于 Model Context Protocol（MCP）的工具，它能强制执行和自动化一系列开发实践，帮助开发者更高效地进行项目开发。

🚀 快速开始

MCP 服务器提供了一系列工具，可帮助实施和自动化以下开发实践：

• 分支名称验证
• 版本管理
• 提交拉取请求准备
• 许可证头文件管理
• 预提交钩安装

📦 安装指南

常规安装

pip install mcp-server-practices

开发环境安装

pip install -e .

使用 UV 工具安装

如果你想使用 UV 工具全局安装该包，请按照以下步骤操作以避免文件损坏：

选项 1：使用 install_full 脚本

# 清理、构建和一次性安装
./install_full.sh

此脚本将执行以下操作：

1. 清理之前的构建 artifacts
2. 构建包
3. 使用 UV 工具安装最新生成的 wheel 文件

选项 2：手动过程

1. 首先，构建包的 wheel 文件：

   python -m build
   

2. 直接安装 wheel 文件（而不是源目录）：

   uv tool install dist/mcp_server_practices-0.3.0-py3-none-any.whl
   

⚠️ 重要提示

请不要直接使用 uv tool install . 命令在源目录上，因为这可能导致文件损坏。始终先构建 wheel 文件。

💻 使用示例

作为 MCP 服务器

该服务器可以通过以下方式调用：

# 使用 --from 参数运行服务器
uvx --from mcp-server-practices practices [选项]

# 显示版本号
uvx --from mcp-server-practices practices --version

⚠️ 重要提示

直接通过 uvx mcp-server-practices 调用的功能支持计划在未来的版本中实现。

服务器选项

作为 CLI 工具

# 访问 CLI 功能
uvx --from mcp-server-practices practices cli [命令] [选项]

⚠️ 重要提示

直接通过 uvx mcp-server-practices cli 调用的功能支持计划在未来的版本中实现。

分支命令

# 验证分支名称
uvx --from mcp-server-practices practices cli branch validate feature/ABC-123-description

# 创建分支
uvx --from mcp-server-practices practices cli branch create feature/ABC-123-description

Jira 命令

# 获取问题详细信息
uvx --from mcp-server-practices practices cli jira issue ABC-123

# 更新问题状态
uvx --from mcp-server-practices practices cli jira update ABC-123 "In Progress"

📚 详细文档

MCP 配置

"practices": {
  "command": "practices",
  "args": [
    "--log-level",
    "ERROR"
  ],
  "disabled": false,
  "autoApprove": [
    "validate_branch_name",
    "get_branch_info",
    "validate_version"
  ]
}

开发

测试

python -m pytest

许可证头文件

uvx --from mcp-server-practices practices cli headers add /path/to/your/source/directory

📄 许可证

MIT