concierge-hq/concierge

Структура для надёжных MCP-серверов и приложений на базе ИИ.

Протокол контекста модели (MCP) — это стандартизированный способ соединения агентов ИИ с инструментами. Вместо того чтобы показывать плоский список каждого инструмента по каждому запросу, Concierge постепенно раскрывает только то, что действительно актуально. Concierge гарантирует детерминированные результаты и надёжный вызов инструмента.

Начало

[! ПРИМЕЧАНИЕ] Concierge требует Python 3.9+. Рекомендуем устанавливать с uv для более быстрого разрешения зависимостей, но pip работает не хуже.

Постройте новый проект:

Или оберните существующий MCP-сервер на две строки, больше ничего не меняется:

[! СОВЕТ] Concierge работает на уровне протокола MCP. Он динамически меняет, какие инструменты возвращаются через tools/list в зависимости от текущего этапа рабочего процесса. Агенту и клиенту не нужно знать о существовании Concierge, они просто видят всё меньше и более релевантных инструментов на каждом этапе.

[! ПРИМЕЧАНИЕ] Wrap and go сразу же даёт прогрессивное раскрытие инструмента. Добавляйте app.stages и app.transitions, когда хотите полный контроль над рабочим процессом, без необходимости менять код.

Использование

Объединяйте инструменты по шагам

Вместо того чтобы раскрывать всё сразу, объединяйте связанные инструменты.

The Model Context Protocol (MCP) is a standardized way to connect AI agents to tools. Instead of exposing a flat list of every tool on every request, Concierge progressively discloses only what’s relevant. Concierge guarantees deterministic results and reliable tool invocation.

Getting Started

[!NOTE] Concierge requires Python 3.9+. We recommend installing with uv for faster dependency resolution, but pip works just as well.

pip install concierge-sdk

Scaffold a new project:

concierge init my-store    # Generate a ready to run project
cd my-store                # Enter project
python main.py             # Start the MCP server

Or wrap an existing MCP server two lines, nothing else changes:

# Before
from mcp.server.fastmcp import FastMCP
app = FastMCP("my-server")

# After: just wrap it
from concierge import Concierge
app = Concierge(FastMCP("my-server"))

[!TIP] Concierge works at the MCP protocol level. It dynamically changes which tools are returned by tools/list based on the current workflow step. The agent and client don’t need to know Concierge exists, they just see fewer, more relevant tools at each point.

from concierge import Concierge
from mcp.server.fastmcp import FastMCP

app = Concierge(FastMCP("my-server"))

# Your @app.tool() decorators stay exactly the same.
# You can additionally add app.stages and app.transitions.

[!NOTE] The wrap and go gives you progressive tool disclosure immediately. Add app.stages and app.transitions when you want full workflow control, no code changes required.

Usage

Group tools into steps

Instead of exposing everything at once, group related tools together. Only the current step’s tools are visible to the agent:

app.stages = {
    "browse":   ["search_products", "view_product"],
    "cart":     ["add_to_cart", "remove_from_cart", "view_cart"],
    "checkout": ["apply_coupon", "complete_purchase"],
}

Define transitions

Control which steps can follow which. The agent moves forward (or backward) only along paths you allow:

app.transitions = {