IPMC MCP

Небольшой MCP-сервер без зависимостей для представлений надзора PMC Apache Incubator.

Он объединяет:

• данные о жизненном цикле подпроектов из PodlingsMCP

• сигналы сообщества и отчеты из apache-health

Он предоставляет специализированные инструменты уровня Incubator, помогающие IPMC:

• выявлять подпроекты, требующие внимания

• оценивать готовность к выпуску

• создавать сводки по подпроектам

• отмечать необходимость вмешательства менторов

• обобщать закономерности состояния сообщества по подпроектам

Требования

• Python 3.12+

Related MCP server: Podlings MCP

Запуск

python3 server.py

Сервер использует stdio, поэтому он предназначен для запуска клиентом MCP.

Установка

python3 -m pip install -e .

Для инструментов разработки:

python3 -m pip install -e .[dev]

Пример конфигурации клиента MCP

{
  "mcpServers": {
    "ipmc": {
      "command": "python3",
      "args": [
        "/Users/justinmclean/IncubatorMCP/server.py",
        "--podlings-mcp-repo",
        "/Users/justinmclean/PodlingsMCP",
        "--health-mcp-repo",
        "/Users/justinmclean/HealthMCP",
        "--health-source",
        "/Users/justinmclean/incubator/tools/health/reports"
      ]
    }
  }
}

Среда выполнения по умолчанию предполагает, что исходные репозитории MCP и отчеты о состоянии доступны по следующим путям:

• /Users/justinmclean/PodlingsMCP

• /Users/justinmclean/HealthMCP

• reports, если не задан параметр --health-source

Вызовы инструментов также могут переопределять пути к исходным данным с помощью podlings_source и health_source.

Настройте расположения исходных MCP и каталог отчетов о состоянии с помощью аргументов запуска:

• --podlings-mcp-repo: путь к клону PodlingsMCP

• --health-mcp-repo: путь к клону HealthMCP

• --health-source: каталог отчетов apache-health по умолчанию

Тестирование

python3 -m unittest discover -s tests -v

Покрытие

python3 -m coverage run -m unittest discover -s tests
python3 -m coverage report -m

Покрытие ограничено локальным пакетом ipmc, поэтому импортированные дочерние MCP не размывают отчет.

Архитектура

См. docs/architecture.md для ознакомления со структурой модулей, потоком выполнения и структурой тестирования.

Инструменты

ipmc_watchlist

Возвращает подпроекты, которые больше всего нуждаются в внимании IPMC, на основе объединенных сигналов жизненного цикла и состояния.

Аргументы:

• podlings_source: необязательный URL или локальный путь к файлу podlings.xml

• health_source: необязательный каталог отчетов для markdown-отчетов apache-health

• as_of_date: необязательная дата в формате YYYY-MM-DD для представлений, зависящих от длительности

• limit: необязательное максимальное количество результатов

• severity_at_least: необязательный фильтр минимальной серьезности

• include_reasons: необязательный список фильтров причин

graduation_readiness

Оценивает, готов ли подпроект, близок ли к готовности или еще не готов к выпуску.

Аргументы:

• podling: обязательное имя подпроекта

• podlings_source

• health_source

• as_of_date

• include_evidence: необязательное логическое значение, по умолчанию true

• strict_mode: необязательное логическое значение

podling_brief

Возвращает ориентированную на IPMC сводку по одному подпроекту.

Аргументы:

• podling: обязательное имя подпроекта

• podlings_source

• health_source

• as_of_date

• focus: необязательный список областей

• brief_format: необязательный формат summary (краткий) или detailed (подробный)

mentoring_attention_needed

Возвращает подпроекты, где, по-видимому, необходимо вмешательство менторов.

Аргументы:

• podlings_source

• health_source

• as_of_date

• limit: необязательное максимальное количество результатов

• urgency_at_least: необязательный фильтр минимальной срочности

• include_causes: необязательный список фильтров причин

community_health_summary

Возвращает сводку уровня IPMC о закономерностях состояния сообщества по подпроектам.

Аргументы:

• podlings_source

• health_source

• as_of_date

• scope: необязательный параметр all_podlings, active_podlings или reporting_podlings

• group_by: необязательный параметр none, risk_band, mentor_load или age_band

• include_examples: необязательное логическое значение

Значения по умолчанию

• Если параметр podlings_source опущен, используется URL podlings.xml ASF.

• Если параметр health_source опущен, используется --health-source или reports, если этот аргумент запуска не задан.

• Представления надзора по умолчанию фокусируются на текущих подпроектах.

• Анализ состояния отдает предпочтение самому свежему доступному окну в следующем порядке: 3m, 6m, 12m, to-date.

Модель мнений

Этот сервер отделяет исходные факты от производных мнений. Представления о рисках и готовности основаны на:

• охвате менторами

• надежности отчетности

• сигналах одобрения менторов

• активности сообщества

• видимости релизов

• длительности инкубации

• широте участия

Полученные результаты предназначены для поддержки суждений IPMC, а не для их замены.