AIO Tests MCP Server

Ein Open-Source-MCP-Server für AIO Tests – Testmanagement für Jira.

Verbinden Sie Claude, Claude Code, Cursor, VS Code, Windsurf oder einen anderen MCP-Client mit Ihren Jira-Testfällen. Suchen und lesen Sie sie, prüfen Sie das Feldschema eines Projekts, durchsuchen Sie den Ordnerbaum und erstellen oder aktualisieren Sie Fälle – klassisch und BDD – in normaler Konversation.

Funktioniert mit Jira Cloud und Jira Server / Data Center. Selbst gehostet, sodass Ihre Anmeldedaten und Testdaten Ihre Infrastruktur nie verlassen.

uvx aio-tests-mcp-server

Noch nicht auf PyPI. Der obige uvx-Befehl wird mit der ersten Version aktiviert. Verwenden Sie bis dahin Aus dem Quellcode ausführen – das dauert nur zwei Befehle.

Warum es das gibt. Der offizielle AIO Tests MCP-Server ist ein Closed-Source-, remote gehosteter Dienst mit einer mandantenspezifischen URL und nur Cloud-Unterstützung. Dieser hier ist selbst hostbar und prüfbar – Sie können jede Zeile lesen, ihn forken und in Ihrem eigenen Netzwerk ausführen. Er ist meines Wissens der einzige AIO Tests MCP-Server, der Jira Server / Data Center unterstützt, und er hat einen Nur-Lese-Modus, sodass Sie sicher eine KI auf eine Produktionsinstanz richten können.

Werkzeuge

Zehn Werkzeuge, alle auf ein Jira-Projekt bezogen.

Lookup-Felder akzeptieren Namen oder IDs. Sie können "Critical" statt 4 sagen oder /Regression/Checkout statt einer Ordner-ID – Werte werden gegen die Projektkonfiguration aufgelöst, sodass das Modell in derselben Terminologie arbeitet, die Sie in der AIO Tests-Oberfläche sehen.

Updates erhalten die Formatierung. Fall-Updates runden das Dokument mit aktiviertem Rich-Text ab, sodass die Formatierung von Feldern, die Sie nicht angefasst haben, erhalten bleibt, und Klartexteingaben werden entsprechend maskiert.

Related MCP server: jira-aio-mcp-server

Schnellstart

1. Zugriffstoken abrufen

Jira Cloud – Öffnen Sie in Jira AIO Tests → (?)-Symbol → API Access Token und generieren Sie eines. Das Token identifiziert Ihren Mandanten, daher ist keine URL erforderlich.

Jira Server/Data Center – Die AIO Tests-API wird von Ihrer Jira-Basis-URL bereitgestellt und verwendet Ihre Jira-Anmeldedaten (ein persönliches Zugriffstoken oder Benutzername + Passwort).

2. Zu Ihrem MCP-Client hinzufügen

{
  "mcpServers": {
    "aio-tests": {
      "command": "uvx",
      "args": ["aio-tests-mcp-server"],
      "env": {
        "AIO_API_TOKEN": "your_aio_access_token"
      }
    }
  }
}

{
  "mcpServers": {
    "aio-tests": {
      "command": "uvx",
      "args": ["aio-tests-mcp-server"],
      "env": {
        "AIO_ENABLED": "true",
        "JIRA_URL": "https://jira.your-company.com",
        "JIRA_PERSONAL_TOKEN": "your_personal_access_token"
      }
    }
  }
}

Dieselbe JSON wie oben, in der MCP-Einstellungsdatei des Clients (~/.cursor/mcp.json für Cursor, .vscode/mcp.json für VS Code). Cursor akzeptiert auch ein projektlokales mcp.json.

In Claude Code können Sie es mit einem Befehl hinzufügen:

claude mcp add aio-tests --env AIO_API_TOKEN=your_token -- uvx aio-tests-mcp-server

3. Fragen Sie etwas

„Durchsuche PROJ nach veröffentlichten Testfällen mit Tag smoke in /Regression/Checkout und zeig mir die Schritte des ersten."

„Lies PROJ-142 und schreibe BDD-Testfälle, die die Akzeptanzkriterien abdecken."

Konfiguration

Jede Einstellung ist eine Umgebungsvariable; siehe .env.example für die vollständige Liste. Die wichtigsten:

Proxy-Einstellungen (AIO_HTTP_PROXY, AIO_HTTPS_PROXY, AIO_SOCKS_PROXY, AIO_NO_PROXY), Client-Zertifikate und benutzerdefinierte Header werden ebenfalls unterstützt.

Dieselben Optionen sind als CLI-Flags verfügbar:

uvx aio-tests-mcp-server --help

Nur-Lese-Modus

Wenn Sie eine KI auf ein Produktions-Jira richten, möchten Sie wahrscheinlich, dass sie schaut, nicht anfasst:

uvx aio-tests-mcp-server --read-only

Schreibwerkzeuge werden dann vollständig aus der Werkzeugliste ausgeblendet, sodass das Modell sie nie sieht.

HTTP-Transport

Für gemeinsame oder containerisierte Bereitstellungen führen Sie es über Streamable HTTP statt stdio aus:

uvx aio-tests-mcp-server --transport streamable-http --port 8000

Der Server stellt /mcp und einen /healthz-Endpunkt für Kubernetes-Probes bereit.

Mehr-Mandanten-Nutzung

Eine Serverinstanz kann mehrere Benutzer bedienen. Jeder Client sendet sein eigenes AIO Tests-Token pro Anfrage, und die Anfrage wird auf diesen Mandanten begrenzt:

{
  "mcpServers": {
    "aio-tests": {
      "url": "https://aio-mcp.your-company.com/mcp",
      "headers": {
        "X-Aio-Api-Token": "the_users_own_token"
      }
    }
  }
}

Authorization: Token <token> funktioniert als Äquivalent zum X-Aio-Api-Token-Header.

Aus dem Quellcode ausführen

git clone https://github.com/AmirhosseinHanifehzadeh/aio-tests-mcp.git
cd aio-tests-mcp
uv sync
cp .env.example .env   # then fill it in
uv run aio-tests-mcp-server

Führen Sie die Tests aus:

uv run pytest

Einschränkungen

• Umbenennen, Verschieben und Löschen von Ordnern sind nicht implementiert. Die öffentliche AIO Tests-API bietet dafür keinen Endpunkt.

• Testzyklen und Testläufe sind noch nicht abgedeckt. Der aktuelle Werkzeugsatz ist auf Testfallverwaltung beschränkt – Fälle, Ordner, Tags und Projektschema. Beiträge sind willkommen.

FAQ

Ist das der offizielle AIO Tests MCP-Server? Nein. AIO Tests veröffentlicht seinen eigenen MCP-Server als gehosteten Dienst – Closed Source, mit mandantenspezifischer URL und nur Cloud. Dies ist eine unabhängige Open-Source-Implementierung, die Sie selbst ausführen. Sie ist weder mit AIO Tests noch mit Atlassian verbunden oder von ihnen unterstützt.

Funktioniert es mit Jira Data Center oder Jira Server? Ja. Setzen Sie AIO_ENABLED=true und JIRA_URL und authentifizieren Sie sich mit einem Jira-Persönlichen Zugriffstoken oder Benutzername und Passwort. Auf Server/DC wird die AIO Tests-API von Ihrer Jira-Basis-URL bereitgestellt, sodass sie Ihre Jira-Anmeldedaten wiederverwendet. Dies ist der Hauptgrund, diesen Server gegenüber den Alternativen zu wählen – die gehosteten sind nur für Cloud.

Kann ich es mit Claude Code, Claude Desktop, Cursor oder VS Code verwenden? Ja – jeder MCP-Client funktioniert. Siehe Zu Ihrem MCP-Client hinzufügen für fertige Konfiguration.

Ist es sicher, es auf Produktions-Jira zu richten? Führen Sie es mit --read-only (oder READ_ONLY_MODE=true) aus. Schreibwerkzeuge werden dann vollständig aus der Werkzeugliste herausgefiltert, sodass das Modell nie sieht, dass Erstellen oder Aktualisieren eine Option ist.

Wohin gehen meine Anmeldedaten? Nirgendwohin außer auf Ihren eigenen Rechner und Ihre Jira-Instanz. Der Server läuft standardmäßig lokal über stdio und spricht direkt mit der AIO Tests-REST-API. Es gibt keinen zwischengeschalteten Dienst.

Kann eine Serverinstanz ein ganzes Team bedienen? Ja – führen Sie es über HTTP aus und lassen Sie jeden Client sein eigenes Token im X-Aio-Api-Token-Header senden. Siehe Mehr-Mandanten-Nutzung.

Unterstützt es Testzyklen, Ausführungen oder Anhänge? Noch nicht. Der aktuelle Werkzeugsatz deckt Testfallverwaltung ab – Fälle, Ordner, Tags und Projektschema. Zyklen und Ausführungen sind der offensichtliche nächste Schritt; siehe Einschränkungen, und Issues sind willkommen.

Mitwirken

Issues und Pull-Requests sind willkommen – siehe CONTRIBUTING.md. Die Testsuite deckt den Client, die Konfigurationsauflösung, jedes Mixin und jedes Werkzeug ab; bitte halten Sie sie grün und fügen Sie Fälle für neues Verhalten hinzu.

Lizenz

MIT.

Teile dieses Projekts stammen von mcp-atlassian von @sooperset, ebenfalls MIT-lizenziert. Danke für die Grundlage.

Dieses Projekt ist weder mit AIO Tests noch mit Atlassian verbunden oder von ihnen unterstützt.