Agentience Practices MCP Server

🚀 實踐 MCP 服務器

實踐 MCP 服務器是一款專業的 MCP（模型上下文協議）服務器，可通過標準化開發實踐提升 AI 交互。它能讓像 Claude 這樣的 AI 助手在項目和團隊中助力實現一致的開發實踐。

🚀 快速開始

安裝

# 使用 uv 進行安裝（推薦）
uv 工具安裝 mcp_server_practices

配置 Claude

將服務器添加到你的 Claude 配置中：

{
  "mcpServers": {
    "practices": {
      "command": "practices",
      "args": ["server"],
      "disabled": false,
      "autoApprove": [
        "validate_branch_name",
        "get_branch_info",
        "validate_version"
      ]
    }
  }
}

開始交互

現在你可以簡單地讓 Claude 幫助你遵循開發實踐：

• “為 ticket PMS-123 創建一個功能分支”
• “我的當前分支名稱是否有效？”
• “檢查文件中的版本是否一致”
• “將主版本號遞增以進行新發布”
• “生成我當前分支的標準化 PR 描述”

✨ 主要特性

該服務器賦予 AI 助手以下能力：

• 管理 Git 分支 - 創建並驗證符合你規範的分支名稱
• 處理版本控制 - 檢查並保持項目文件中的版本號一致性
• 準備拉取請求 - 生成標準化的 PR 描述並驗證準備狀態
• 工具集成 - 連接 GitHub 和 Jira 以自動化工作流程

💬 自然語言交互

只需用自然語言詢問 Claude：

“為 ticket PMS-123 創建一個新的用戶認證功能分支” “檢查我們的項目版本是否一致” “為我的當前分支準備一個標準化的拉取請求”

MCP 服務器為你項目的配置提供上下文和工具，使 Claude 能正確理解並執行這些請求。

🔧 技術細節

工作原理

1. AI + MCP 服務器協作：該服務器為 Claude 提供工具和資源，幫助你處理開發工作流程
2. 上下文理解：服務器為你項目的特定配置和規範提供信息
3. 智能輔助：Claude 可以根據你的自然語言請求使用適當的 MCP 工具來幫助你遵循最佳實踐

內部情況

當你通過自然語言交互時，服務器為你提供結構化的工具來：

• 驗證分支名稱是否符合可配置的模式
• 檢測分支信息和問題引用
• 檢查文件中的版本一致性
• 生成標準化的 PR 描述
• 自動化 Jira 和 GitHub 的互動

📦 安裝指南

該服務器通過項目特定需求進行調整，具體方式是通過 .practices.yaml 配置文件定義：

• 你首選的分支策略（GitFlow、GitHub Flow 等）
• 版本文件的位置和模式
• Jira 和 GitHub 的集成設置
• PR 描述模板

📚 詳細文檔

• 用戶指南 - 詳細使用說明及自然語言示例
• 配置指南 - 自定義服務器設置
• CLI 參考 - 高級用戶的直接命令行使用
• 開發者文檔 - 擴展服務器

🤝 支持與貢獻

歡迎提出問題和拉取請求！有關更多信息，請參閱我們的貢獻指南。

📄 許可證

MIT