Skip to main content
Glama
deenesjakoruzh
samularagran1408-bot

Inklusport MCP Server (Python)

by samularagran1408-bot
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Inklusport MCP サーバー (Python)

MCP (Model Context Protocol) サーバー。クラスの例と同じベース (mcp>=2.0.0、MCPServer、@server.tool、HTTP トランスポート) を使用。

ドメインツールは データベースにアクセスせず、ink-ms-users (ポート 3002) と ink-ms-sports (ポート 3003) に HTTP GET リクエストを送信します。ロールごとのエージェント (ユーザー、トレーナー、主催者、管理者) は、自分に対応するツールのみ表示できます。

ツール (読み取りと管理 → マイクロサービス)

ツール

マイクロサービス

エンドポイント

テストケース

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} (またはメール → 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: Strava MCP Broker

ロールごとのエージェント

.env 内の AGENT_ROLE (または起動時) でツールをフィルタリング:

ロール

ツール

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 が表示されるはずです。ヘルスチェック: http://127.0.0.1:8000/。

3. テストクライアント (別のターミナル)

.\.venv\Scripts\Activate.ps1
python src/client_test.py

4. ロールごとに1プロセス (オプション)

# 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

4つすべてを使用した 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/<role>.md のプロンプトをエージェントの指示として貼り付けます。

  5. テスト: 「Inklusport にはどんなイベントがありますか？」。応答に "via": "mcp" フィールドが含まれている場合、エージェントはサーバーを使用しており、データを捏造していません。

マイクロサービス

モノレポのルートから:

docker compose up -d users-service sports-service

ポート: Users 3002、Sports 3003。読み取りクエリは permitAll です。書き込みツール (作成/編集/キャンセル/登録) は Sports API の同じエンドポイントを呼び出し、セキュリティプロファイルに応じて JWT が必要になる場合があります。

This server cannot be deployed

Pay for results, not tokens.Fund a bounty. Let AI agents compete and collaborate to solve your problems.agentbounties.appAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Strava MCP Broker

    julianbruegger
    F
    license
    Not graded
    quality
    D
    maintenance
    An 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.
    -

  • eventos MCP Server

    bsj-m-takigawa
    F
    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
    -

  • wger MCP Server

    penelope1234564867
    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.
    -