Czech Transport Assistant by CzechFabric | Český dopravní asistent od CzechFabric

🇨🇿 CzechFabric SDK

チェコの公共サービス（交通、位置情報、コンテキストに応じた AI ツールなど）向けの統合 API、**Czech Intelligence Fabric（MCP）**にアクセスするための公式 Python SDK です。

---

🚀 特長

• ✅ OpenTripPlanner を使用した公共交通機関の経路検索
• 🚏 停留所名または座標からリアルタイムの出発情報を取得
• 🗺️ 位置情報のジオコーディング／リバースジオコーディング
• 📍 近くの停留所を検索
• 📦 停留所のメタデータとゾーン情報を取得
• 🧠 利用可能なツールを一覧表示し、LLM 向けの概要を生成
• 🔁 リトライ、キャッシュ、エラー処理を標準搭載

---

📦 インストール

pip install czechfabric-sdk

---

⚡ クイックスタート

from czechfabric_sdk.client import CzechFabricClient

client = CzechFabricClient(
    api_key="your-api-key",
    base_url="https://mcp.czechfabric.cz"
)

# Example: Plan a trip
trip = await client.plan_trip("Florenc", "Karlovo náměstí", departure_time="in 15 minutes")
print(trip)

---

📚 使用例

詳しい例は examples.md をご覧ください。

• 🚉 経路を検索
• 📆 出発情報を取得
• 🧭 ジオコーディング／リバースジオコーディング
• 📍 近くの停留所
• 🧾 停留所のメタデータ
• 📋 停留所を一覧表示
• 🛠️ 利用可能なツールを一覧表示
• 🤖 プロンプト概要を生成

---

🧰 ツール管理

MCP サーバーが公開しているツールを動的に一覧表示できます。

tools = await client.get_tool_names()
prompt = await client.get_tool_prompt_summary()
print(prompt)

LLM ベースのアシスタントや、利用可能な機能のデバッグに便利です。

---

🔐 認証

すべてのリクエストに API キーが必要です。

client = CzechFabricClient(api_key="your-api-key", base_url="https://mcp.czechfabric.cz")

CzechFabric のユーザーダッシュボードからキーを生成できます。

---

⚠️ エラー処理

SDK は次の構造化された例外を提供します。

• NetworkError – サーバーに到達できない、またはタイムアウトした場合
• InvalidAPIKeyError – 認証に失敗した場合
• RateLimitExceededError – リクエスト数が多すぎる場合
• ToolExecutionError – ツールの実行に失敗した場合

---

🧪 テストの実行

pip install -r requirements-dev.txt
pytest tests/

---

📎 ライセンス

MIT © 2025 Aliyu Abdulbasit Ayinde

---

🌐 プロジェクトリンク

• 🧠 MCP サーバー：https://mcp.czechfabric.cz
• 💬 フィードバックと問題の報告：GitHub Issues