Skip to main content
Glama
Inklusport MCP Server (Python)

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). Агент по роли (пользователь, тренер, организатор, администратор) видит только те инструменты, которые ему соответствуют.


Инструменты (чтение и управление → микросервисы)

Инструмент

Микросервис

Конечная точка

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

listar_discapacidades

sports

GET /api/disabilities

CP1-HU16.2

consultar_discapacidad

sports

GET /api/disabilities/{id}

CP2-HU16.2

registrar_discapacidad

sports

POST /api/disabilities

CP1-HU16.1, CP2-HU16.1

editar_discapacidad

sports

PUT /api/disabilities/{id}

CP1-HU16.3, CP2-HU16.3

desactivar_discapacidad

sports

PATCH /api/disabilities/{id}/deactivate

CP1-HU16.4, CP2-HU16.4

reactivar_discapacidad

sports

PATCH /api/disabilities/{id}/activate

CP1-HU16.4

listar_adaptaciones_deporte

sports

GET /api/sport-disabilities/sport/{sportId}

CP1-HU17, CP2-HU17

listar_eventos

sports

GET /api/events

CP1-HU18

crear_evento

sports

POST /api/events

CP2-HU18, CP1-HU18.1, CP2-HU18.1

listar_eventos_disponibles

sports

GET /api/events/available

CP1-HU18.2

consultar_evento

sports

GET /api/events/{id}

CP2-HU18.2

editar_evento

sports

PUT /api/events/{id}

CP1-HU18.3, CP2-HU18.3

cancelar_evento

sports

POST /api/events/{id}/cancel

CP1-HU18.4, CP2-HU18.4

inscribirse_evento

sports

POST /api/registrations

CP1-HU18.5, CP2-HU18.5

consultar_calendario_eventos

sports

GET /api/events/calendar

CP1-HU19, CP2-HU19

consultar_usuario

users

GET /api/internal/users/{id} (или email → id-by-email)

—

consultar_inscripciones

sports

GET /api/registrations/user/{userId}

—

consultar_roles_por_email

users

GET /api/internal/users/roles-by-email

—

listar_rutinas_publicadas

sports

GET /api/routines

—

listar_rutinas_entrenador

sports

GET /api/routines/trainer/{trainerId}

—

listar_deportes

sports

GET /api/sports/active

—


Related MCP server: Enterprise MCP Gateway and Tool Registry

Агенты по ролям

AGENT_ROLE в .env (или при запуске) фильтрует инструменты:

Роль

Инструменты

usuario

события, доступные, календарь, записаться, виды спорта, профиль, записи, адаптации

entrenador

события, календарь, профиль, программы, адаптации, ограничения (CRUD/активация)

organizador

события (CRUD/отмена), календарь, ограничения, записи, адаптации

admin

все инструменты управления событиями, ограничениями, пользователями, программами и адаптациями

all

все перечисленные выше

Инструкции для 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:3003

TRANSPORT: sse, streamable-http или stdio.


Быстрый старт (Windows)

1. Окружение и установка

cd ink-mcp-inklusport
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

2. 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.py

4. Один процесс на роль (опционально)

# 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

  1. Установите Antigravity IDE (не «чистый» агент 2.0).

  2. Запустите сервер с TRANSPORT=streamable-http.

  3. Добавьте MCP: http://127.0.0.1:8000/mcp.

  4. Вставьте промпт из agents/<роль>.md как инструкции агента.

  5. Проверьте: «Какие события есть в 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…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP 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
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP 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.
      -