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 调用的功能支持计划在未来的版本中实现。

服务器选项

• --log-level：设置日志级别（DEBUG、INFO、WARNING、ERROR、CRITICAL）
• --project-root：指定项目根目录
• --log-file：启用文件日志记录（默认）
• --no-log-file：禁用文件日志记录
• --log-file-path：指定自定义日志文件路径

作为 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