ASF-Richtlinien-MCP

MCP-Server zur Beantwortung von Fragen zu den Richtlinien der Apache Software Foundation.

Deckt die vollständige Liste der Richtlinien unter https://www.apache.org/board/policies ab — Releases, Lizenzierung, Branding, Sicherheit, Infrastruktur, Inkubator und mehr.

Richtlinienseiten werden lokal für 30 Tage zwischengespeichert. Verwenden Sie force_refresh=true bei Lese-Tools, um den Cache für einen einzelnen Aufruf zu umgehen.

Installation

python3 -m venv .venv
. .venv/bin/activate
pip install -e .

Ausführen

asf-policy-mcp

Für die lokale Entwicklung:

python -m asf_policy_mcp.server

Testen

pip install -e ".[dev]"
make check

Konfiguration mit Claude Desktop oder Codex

{
  "mcpServers": {
    "asf-policy": {
      "command": "<path to PolicyMCP>/.venv/bin/python",
      "args": ["-m", "asf_policy_mcp.server"]
    }
  }
}

Tools

• list_policies — Listet alle verfügbaren Richtliniendokumente nach Abschnitten sortiert auf, inklusive Cache-Status.

• get_policy — Ruft den vollständigen Text eines Richtliniendokuments anhand seines Schlüssels ab (z. B. release_policy, branding, incubator).

• search_policies — Stichwortsuche in allen Richtliniendokumenten; gibt bewertete Auszüge mit Kontext zurück.

• refresh_cache — Erzwingt das erneute Abrufen eines oder aller Richtliniendokumente von der ASF-Website.

Beispielfragen

Releases

• Welche Dateien müssen in einem Release-Artefakt enthalten sein, damit es gültig ist?

• Können wir ein Release mit nur einer +1-Stimme vom PMC veröffentlichen?

• Wo müssen Release-Artefakte veröffentlicht werden — können wir GitHub Releases als primären Download verwenden?

Inkubator

• Was muss ein Podling tun, bevor es den Inkubator verlassen kann?

• Kann ein Podling ein Release veröffentlichen, bevor es den Inkubator verlässt, und welche zusätzlichen Anforderungen gelten?

• Wer darf über ein Podling-Release abstimmen und wessen Stimmen sind bindend?

Lizenzierung

• Ist die MIT-Lizenz mit Apache 2.0 für die Bündelung in einem Release kompatibel?

• Können wir eine Bibliothek einbinden, die unter LGPL 2.1 lizenziert ist?

• Was ist eine Kategorie-X-Lizenz und warum ist sie wichtig?

• Benötigen wir eine CLA von jedem Mitwirkenden oder nur von Committern?

• Welche Lizenz-Header sind in Quelldateien erforderlich?

Sicherheit

• Wenn jemand eine Sicherheitslücke privat meldet, wie lange haben wir Zeit, diese offenzulegen?

• Sollten Sicherheitsprobleme auf der öffentlichen Entwickler-Mailingliste diskutiert werden?

Branding

• Darf ein Dritter "Apache Foo" im Namen seines kommerziellen Produkts verwenden?

• Was muss auf einer Projekt-Website für die Einhaltung von Markenrichtlinien erscheinen?

Richtliniendokumente