concierge-hq/concierge

信頼性の高いMCPサーバーやAIアプリケーションのファブリックです。

モデルコンテキストプロトコル(MCP)は、AIエージェントをツールに接続する標準化された方法です。すべてのリクエストですべてのツールをフラットリストに公開するのではなく、Conciergeは関連するものだけを段階的に公開します。Conciergeは決定論的な結果と信頼性の高いツール呼び出しを保証します。

始めて

[!注] コンシェルジュはPython 3.9+を必要とします。依存関係の解決を速めるためにuvでのインストールを推奨しますが、pipも同様に動作します。

新しいプロジェクトの足場を築く:

**あるいは既存のMCPサーバーを2行だけラップしても、他には何も変わりません:

[!ヒント] コンシェルジュはMCPプロトコルレベルで動作します。現在のワークフローステップに応じて、tools/listが返却するツールを動的に変更します。エージェントとクライアントはコンシェルジュの存在を知る必要はなく、各ポイントでより少ない、より関連性の高いツールを見るだけです。

[!注] ラップ&ゴーはプログレッシブツールの開示を即座に提供します。ワークフローを完全にコントロールしたいときは、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 = {