Inklusport MCP Server (Python)
Inklusport MCP-Server (Python)
MCP (Model Context Protocol)-Server auf Basis des Unterrichtsbeispiels
(mcp>=2.0.0, MCPServer, @server.tool, HTTP-Transport).
Die Domänen-Tools greifen nicht auf Datenbanken zu: Sie führen GET-HTTP-Anfragen an
ink-ms-users (Port 3002) und ink-ms-sports (Port 3003) aus. Ein Agent pro Rolle
(Benutzer, Trainer, Organisator, Admin) sieht nur die für ihn relevanten Tools.
Tools (Lesen und Verwalten → Microservices)
Tool | Microservice | Endpunkt | Testfälle |
| sports |
| CP1-HU16.2 |
| sports |
| CP2-HU16.2 |
| sports |
| CP1-HU16.1, CP2-HU16.1 |
| sports |
| CP1-HU16.3, CP2-HU16.3 |
| sports |
| CP1-HU16.4, CP2-HU16.4 |
| sports |
| CP1-HU16.4 |
| sports |
| CP1-HU17, CP2-HU17 |
| sports |
| CP1-HU18 |
| sports |
| CP2-HU18, CP1-HU18.1, CP2-HU18.1 |
| sports |
| CP1-HU18.2 |
| sports |
| CP2-HU18.2 |
| sports |
| CP1-HU18.3, CP2-HU18.3 |
| sports |
| CP1-HU18.4, CP2-HU18.4 |
| sports |
| CP1-HU18.5, CP2-HU18.5 |
| sports |
| CP1-HU19, CP2-HU19 |
| users |
| — |
| sports |
| — |
| users |
| — |
| sports |
| — |
| sports |
| — |
| sports |
| — |
Related MCP server: Strava MCP Broker
Agenten pro Rolle
AGENT_ROLE in .env (oder beim Start) filtert die Tools:
Rolle | Tools |
| Veranstaltungen, Verfügbare, Kalender, Anmelden, Sportarten, Profil, Anmeldungen, Anpassungen |
| Veranstaltungen, Kalender, Profil, Routinen, Anpassungen, Behinderungen (CRUD/aktivieren) |
| Veranstaltungen (CRUD/stornieren), Kalender, Behinderungen, Anmeldungen, Anpassungen |
| Alle Tools für Veranstaltungsverwaltung, Behinderungen, Benutzer, Routinen und Anpassungen |
| Alle oben genannten |
Anleitungen für Antigravity: agents/usuario.md, entrenador.md, organizador.md, admin.md.
Struktur
ink-mcp-inklusport/
├── requirements.txt
├── .env / .env.example
├── README.md
├── agents/ # prompts y config MCP para Antigravity
└── src/
├── server.py # servidor MCP y registro de tools
├── ms_client.py # GET HTTP a Users/Sports
└── client_test.py # cliente de prueba (como en clase)Konfiguration (.env)
TRANSPORT=streamable-http
HOST=127.0.0.1
PORT=8000
AGENT_ROLE=all
USERS_SERVICE_URL=http://localhost:3002
SPORTS_SERVICE_URL=http://localhost:3003TRANSPORT: sse, streamable-http oder stdio.
Schnellstart (Windows)
1. Umgebung und Installation
cd ink-mcp-inklusport
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt2. MCP-Server
Users und Sports sind für den Start nicht zwingend erforderlich. Ohne sie geben die Tools
success=false zurück (Microservice nicht erreichbar).
python src/server.pySie sollten http://127.0.0.1:8000 sehen. Health: http://127.0.0.1:8000/.
3. Test-Client (anderes Terminal)
.\.venv\Scripts\Activate.ps1
python src/client_test.py4. Ein Prozess pro Rolle (optional)
# terminal 1
$env:AGENT_ROLE="usuario"; $env:PORT="8000"; python src/server.py
# terminal 2
$env:AGENT_ROLE="entrenador"; $env:PORT="8001"; python src/server.py
# terminal 3
$env:AGENT_ROLE="organizador"; $env:PORT="8002"; python src/server.py
# terminal 4
$env:AGENT_ROLE="admin"; $env:PORT="8003"; python src/server.pyAntigravity-Konfiguration mit allen vier: agents/antigravity.roles.mcp.json.
Mit einem einzelnen Server (AGENT_ROLE=all): agents/antigravity.mcp.json.
Antigravity
Installieren Sie Antigravity IDE (nicht den „reinen“ Agent 2.0).
Starten Sie den Server mit
TRANSPORT=streamable-http.Fügen Sie den MCP hinzu:
http://127.0.0.1:8000/mcp.Fügen Sie den Prompt aus
agents/<rolle>.mdals Agentenanweisungen ein.Testen Sie: „Welche Veranstaltungen gibt es in Inklusport?“. Wenn die Antwort das Feld
"via": "mcp"enthält, verwendet der Agent den Server und erfindet keine Daten.
Microservices
Vom Stammverzeichnis des Monorepos:
docker compose up -d users-service sports-servicePorts: Users 3002, Sports 3003. Leseabfragen sind permitAll.
Schreib-Tools (erstellen/bearbeiten/stornieren/anmelden) rufen dieselben
Endpunkte der Sports-API auf und können je nach Sicherheitsprofil ein JWT erfordern.
This server cannot be deployed
Maintenance
Related MCP Connectors
Eventify MCP server — manage events, attendees, sessions, speakers, sponsors, and analytics.
Strava MCP tools for AI: athletes, activities, segments, clubs, routes. Powered by HAPI MCP server.
Hosted MCP endpoint with realistic fake data for prototyping agents. 12 tools, no setup.
Discover, hire, and verify real-world physical capability through MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to discover and execute tools via a secure MCP server with JWT authentication, RBAC, rate limiting, and audit logging.1MIT
- FlicenseNot gradedqualityDmaintenanceAn HTTP broker that exposes Strava data and operations (activities, routes, segments, etc.) as MCP tools, allowing users to interact with their own Strava account via natural language using per-user OAuth2 authentication.-
- FlicenseNot gradedqualityDmaintenanceMCP server for eventos event management platform, enabling AI assistants to manage events and tickets via API integration. Supports authentication, ticket CRUD operations, and listing with pagination.1-
- FlicenseNot gradedqualityDmaintenanceMCP server that wraps wger fitness/nutrition management platform, providing 15 tools for exercise search, ingredient nutrition lookup, weight tracking, and more, accessible to any MCP-compatible AI agent.-