Skip to main content
Glama
mihey3000

Shopping List MCP Server

by mihey3000
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
Python
Hybrid

MCP списка покупок

Самостоятельный MCP-сервис. Он не открывает SQLite и не содержит бизнес-логику: все операции выполняются через REST веб-приложения.

Режимы авторизации

На сервере MCP работает как OAuth 2.1 Resource Server. Клиент получает access token у Keycloak и передаёт его как Authorization: Bearer <token>. Сервер публикует метаданные защищённого ресурса MCP, а затем проверяет токен через Keycloak Introspection: активность, issuer, audience, scope и срок действия. Статический токен допускается только в локальном режиме разработки.

Related MCP server: alexa-mcp

Запуск с OAuth 2.1

Сначала запустите приложение из репозитория shopping-list-app на порту 8000. Затем в этом каталоге:

../shopping-list-app/.venv/bin/python -m pip install -e ".[dev]"
cp .env.example .env
# Заполните MCP_OAUTH_* значениями из Keycloak.
set -a; source .env; set +a
../shopping-list-app/.venv/bin/python -m mcp_adapter.server

MCP будет доступен по http://127.0.0.1:8001/mcp/.

Для удалённого приложения укажите публичные HTTPS-адреса:

SHOPPING_APP_URL=https://app.example.com \\
MCP_RESOURCE_SERVER_URL=https://mcp.example.com/mcp \\
../shopping-list-app/.venv/bin/python -m mcp_adapter.server

Конфигурация Keycloak и сценарий для пользователя reviewer — в docs/keycloak.md. Выгрузка MCP как самостоятельного systemd-сервиса без Docker — в deploy/README.md.

Локальная разработка без Keycloak

Этот режим нужен только для быстрых локальных smoke-тестов. Он не реализует OAuth discovery и не должен попадать в серверную конфигурацию.

MCP_AUTH_MODE=development \\
MCP_AUTH_TOKEN='длинный-случайный-токен' \\
../shopping-list-app/.venv/bin/python -m mcp_adapter.server

Проверка

../shopping-list-app/.venv/bin/python -m pip install -e ".[dev]"
../shopping-list-app/.venv/bin/python -m pytest
export MCP_AUTH_MODE=development
export MCP_AUTH_TOKEN='длинный-случайный-токен'
../shopping-list-app/.venv/bin/python scripts/mcp_smoke.py

В этом локальном режиме каждый HTTP-запрос должен передавать тот же токен:

Authorization: Bearer <MCP_AUTH_TOKEN>

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • MCP Auth

    rubenpenap
    A
    license
    Not graded
    quality
    D
    maintenance
    A remote MCP server implementation that demonstrates authentication and authorization capabilities using OAuth 2.1. This is a workshop project for learning how to build secure MCP servers with user authentication.
    18,923
    MIT

  • alexa-mcp

    GraysonCAdams
    A
    license
    A
    quality
    D
    maintenance
    An MCP server that enables users to manage their Amazon Alexa shopping lists directly from MCP clients like Claude. It provides tools for listing, adding, updating, and deleting shopping list items through secure Amazon account authentication.
    7
    MIT

  • keycloak-mcp

    shigechika
    A
    license
    A
    quality
    A
    maintenance
    An MCP server for Keycloak Admin REST API, enabling user, group, event, and security management through service account authentication.
    30
    MIT

  • mcp_auth_server

    dawa
    F
    license
    Not graded
    quality
    D
    maintenance
    A proof-of-concept MCP server implementing OAuth 2.1 authorization with CIMD client registration and PKCE, demonstrating protected resource access and step-up authentication.
    -