Inklusport MCP Server (Python)
Сервер MCP Inklusport (Python)
Сервер MCP (Model Context Protocol) на той же основе, что и пример из занятий
(mcp>=2.0.0, MCPServer, @server.tool, транспорт HTTP).
Инструменты предметной области не обращаются к базам данных: они выполняют GET-запросы к
ink-ms-users (порт 3002) и ink-ms-sports (порт 3003). Агент по роли
(пользователь, тренер, организатор, администратор) видит только те инструменты, которые ему соответствуют.
Инструменты (чтение и управление → микросервисы)
Инструмент | Микросервис | Конечная точка | Тестовые сценарии |
| 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: Enterprise MCP Gateway and Tool Registry
Агенты по ролям
AGENT_ROLE в .env (или при запуске) фильтрует инструменты:
Роль | Инструменты |
| события, доступные, календарь, записаться, виды спорта, профиль, записи, адаптации |
| события, календарь, профиль, программы, адаптации, ограничения (CRUD/активация) |
| события (CRUD/отмена), календарь, ограничения, записи, адаптации |
| все инструменты управления событиями, ограничениями, пользователями, программами и адаптациями |
| все перечисленные выше |
Инструкции для Antigravity: agents/usuario.md, entrenador.md, organizador.md, admin.md.
Структура
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)Конфигурация (.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 или stdio.
Быстрый старт (Windows)
1. Окружение и установка
cd ink-mcp-inklusport
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt2. MCP-сервер
Users и Sports не обязательны для запуска. Без них инструменты
возвращают success=false (микросервис недоступен).
python src/server.pyВы должны увидеть http://127.0.0.1:8000. Health: http://127.0.0.1:8000/.
3. Тестовый клиент (другой терминал)
.\.venv\Scripts\Activate.ps1
python src/client_test.py4. Один процесс на роль (опционально)
# 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.pyКонфигурация Antigravity с четырьмя ролями: agents/antigravity.roles.mcp.json.
С одним сервером (AGENT_ROLE=all): agents/antigravity.mcp.json.
Antigravity
Установите Antigravity IDE (не «чистый» агент 2.0).
Запустите сервер с
TRANSPORT=streamable-http.Добавьте MCP:
http://127.0.0.1:8000/mcp.Вставьте промпт из
agents/<роль>.mdкак инструкции агента.Проверьте: «Какие события есть в Inklusport?». Если ответ содержит поле
"via": "mcp", агент использует сервер, а не выдумывает данные.
Микросервисы
Из корня монорепозитория:
docker compose up -d users-service sports-serviceПорты: Users 3002, Sports 3003. Запросы на чтение имеют permitAll.
Инструменты записи (создать/редактировать/отменить/записаться) вызывают те же
конечные точки API Sports и могут требовать JWT в зависимости от профиля безопасности.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Eventify MCP server — manage events, attendees, sessions, speakers, sponsors, and analytics.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
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.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables management of Expokossodo 2025 events through 7 MCP tools for checking events, attendee registration, capacity monitoring, attendance confirmation, and real-time statistics. Features JWT authentication with role-based permissions for event coordinators and staff.-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to discover and execute tools via a secure MCP server with JWT authentication, RBAC, rate limiting, and audit logging.1MIT
- AlicenseNot 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.1MIT
- 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.-