AI导哈

多服务器架构开发工具

MCP Tools是一个模块化的FastMCP服务器架构，提供开发工具、分析和报告功能，用于Claude Code集成。

  • by dlightyupgrade
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 dlightyupgrade/mcp-tools

使用说明

MCP工具-多服务器架构

模块化的FastMCP服务器架构，为Claude Code集成提供开发工具、分析和报告。

🏗️ 架构概述

MCP工具使用 多服务器组合 具有三个专用服务器的架构：

  • 🎯 协调者 (localhost:8002)-编写工具和报告的主编排服务器
  • 🛠️ 工具 (localhost:8003)-开发工作流程自动化（PR分析、代码审查、JIRA）
  • 📈 报告 (localhost:8004)-绩效分析和报告（季度报告、指标）

所有服务器都可以运行 独立地 或 组合在一起 通过使用FastMCP的协调器 mount() 图案。

🚀 快速开始

容器优先部署（推荐）

# Start all services
./scripts/start.sh

# Check status
./scripts/status.sh

# Stop all services
./scripts/stop.sh

# Add to Claude Code (coordinator endpoint)
claude mcp add mcp-tools http://localhost:8002/mcp/ --transport http --scope user

开发设置

# Install dependencies
poetry install

# Run coordinator (mounts all servers)
poetry run python coordinator/server.py

# Or run individual servers
poetry run python tools/server.py      # Tools only (port 8003)
poetry run python reports/server.py    # Reports only (port 8004)

📊 服务端点

服务 端口 健康检查 目的
协调者 8002 http://localhost:8002/health 主组成服务器
工具 8003 http://localhost:8003/health 开发工作流程
报告 8004 http://localhost:8004/health 分析和报告

🛠️ 可用工具（14个核心工具）

开发工作流工具（工具服务器）

1.公关健康(pr_health)

分析PR运行状况，包括打开的审核线程、CI状态和合并准备情况。

  • 输入：GitHub PR URL，可选描述
  • 输出：具有可操作解决方案的全面健康分析
  • 示例: "pr_health https://github.com/owner/repo/pull/123"

2.代码审查(code_review)

执行全面的代码质量审查，并进行安全和性能分析。

  • 输入：GitHub PR URL，可选焦点区域，最大差异行数
  • 输出：结构化代码质量评估
  • 示例: "code_review https://github.com/owner/repo/pull/123 security"

3.技术设计评审(tech_design_review)

审查技术设计文档，包括架构和实现分析。

  • 输入：文档URL（Confluence/GitHub），可选焦点区域
  • 输出：设计审查和架构建议
  • 示例: "tech_design_review https://company.atlassian.net/wiki/pages/123456"

4.JIRA过渡(jira_transition)

通过智能状态管理自动化JIRA工作流转换。

  • 输入：票证ID，目标状态（支持别名：“dev”、“review”、”qa“、”done“）
  • 输出：使用Atlassian MCP集成的JIRA转换说明
  • 示例: "jt SI-1234 start" 或 "jira_transition SI-1234 development"

5.获取JIRA过渡(get_jira_transitions)

计算JIRA状态之间的最佳转换路径。

  • 输入：从状态，可选到状态
  • 输出：使用MCP命令逐步过渡路径
  • 示例: "get_jira_transitions 'Open' 'In Development'"

6.史诗状态报告(epic_status_report)

通过子任务分析和进度跟踪生成全面的史诗状态。

  • 输入：史诗门票ID，可选焦点区域
  • 输出：对受让人行动项目进行史诗般的进度分析
  • 示例: "epic_status_report SI-9038"

分析和报告工具（报表服务器）

7.季度团队报告(quarterly_team_report)

使用匿名指标生成全面的季度团队绩效报告。

  • 输入：团队前缀、年份、季度、可选描述
  • 输出：使用JIRA和GitHub数据进行团队分析
  • 示例: "quarterly_team_report SI 2025 2"

8.季度环比分析(quarter_over_quarter_analysis)

分析多个季度的团队绩效趋势和规模变化。

  • 输入：团队前缀，期间（例如“2024”、“2023-2025”）
  • 输出：多季度趋势分析，团队构成跟踪
  • 示例: "quarter_over_quarter_analysis SI 2024"

9.个人季度报告(personal_quarterly_report)

为个人发展生成个人贡献者绩效报告。

  • 输入：团队前缀、年份、季度
  • 输出：个人绩效分析及成长建议
  • 示例: "personal_quarterly_report SI 2025 2"

10.个人季度环比(personal_quarter_over_quarter)

分析多个时间段的个人绩效趋势和增长。

  • 输入：团队前缀，句号
  • 输出：具有发展洞察力的个人成长分析
  • 示例: "personal_quarter_over_quarter SI 2024"

系统和实用工具

11.设置先决条件(setup_prerequisites)

验证并设置MCP工具所需的所有先决条件。

  • 输出：使用设置说明进行全面验证
  • 特性：GitHub CLI、JIRA访问、工具可用性检查

12.检查工具要求(check_tool_requirements)

检查单个MCP工具的特定先决条件。

  • 输入：工具名称
  • 输出：工具特定验证结果

13.回声(echo)

MCP通信验证的简单连接测试。

14.获取系统信息(get_system_info)

系统诊断和服务器健康监控。

🐳 容器架构

多级Dockerfiles

  • 建设者阶段：诗歌依赖安装
  • 生产阶段：非root用户的最小运行时间
  • 连拱的：支持AMD64和ARM64架构

集装箱特征

  • 健康检查：内置 /health 所有服务的端点
  • 安全：非root用户执行
  • 日志记录：具有可配置级别的结构化日志记录
  • 网络：用于服务通信的隔离网桥网络

Docker编写服务

services:
  mcp-coordinator:   # Main orchestration (port 8002)
  mcp-tools:         # Development tools (port 8003)
  mcp-reports:       # Analytics server (port 8004)

🔧 开发与部署

环境变量

变量 默认值 描述
MCP_SERVER_PORT 8002/8003/8004 服务器端口
LOG_LEVEL 信息 日志记录级别
MOUNT_TOOLS true 装载工具服务器（仅限协调器）
MOUNT_REPORTS true 装载报表服务器（仅限协调器）

容器管理

# Build all containers
podman-compose build

# Start with logs
podman-compose up

# Background mode
podman-compose up -d

# Check status
podman-compose ps

# View logs
podman-compose logs -f mcp-coordinator

🎯 集成模式

Claude代码集成

# Primary endpoint (coordinator with all tools)
claude mcp add mcp-tools http://localhost:8002/mcp/ --transport http --scope user

# Individual servers (if needed)
claude mcp add mcp-tools-dev http://localhost:8003/mcp/ --transport http --scope user
claude mcp add mcp-reports http://localhost:8004/mcp/ --transport http --scope user

工作流示例

# Complete development workflow
claude "jt SI-1234 start -> pr_health https://github.com/owner/repo/pull/123 -> code_review same_url"

# Quarterly reporting workflow  
claude "quarterly_team_report SI 2025 2 -> personal_quarterly_report SI 2025 2"

# Epic management workflow
claude "epic_status_report SI-9038 -> jt SI-1234 start -> create implementation plan"

🚨 Alpha开发状态

MCP Tools目前处于alpha开发阶段：

  • ⚠️ 未准备好生产-功能和精度不保证
  • 🔬 仅供内部使用-需要数据验证
  • 📊 报告输出需要手动验证
  • 🔄 格式和结构可能会更改，恕不另行通知

🏗️ 架构优势

模块化

  • 独立部署：每台服务器都可以独立运行
  • 专业关注点：开发工具与报告分开
  • 可扩展的：添加新服务器而不修改现有服务器

FastMCP组成

  • 服务器安装：协调器安装专用服务器
  • 统一接口：具有所有工具的单一端点
  • 服务发现：自动工具注册和健康监测

集装箱优先设计

  • 生产就绪：采用安全最佳实践的多阶段构建
  • 编排：Docker Compose具有网络和健康检查功能
  • 可移植性：在开发和生产环境中一致运行

需求：Python 3.11+，诗歌，Podman/Docker，Git，curl，jq

相关 MCP