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

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

远程服务
github.com/czechfabricAI 与智能体065 周前更新
代码仓库

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

这是用于访问 CzechFabric 的官方 Python SDK，提供包括交通和地理位置在内的捷克公共服务能力。它支持行程规划和实时站点信息，并内置缓存、重试及结构化错误处理。

主要功能

  1. 01规划公共交通行程
  2. 02获取实时发车信息
  3. 03地理编码与反向地理编码
  4. 04查找附近站点及站点详情
  5. 05列出服务端工具和提示词摘要
  6. 06内置缓存、重试与错误处理

适用场景

  1. 01规划公共交通路线
  2. 02查询站点或坐标对应的发车信息
  3. 03查找附近站点并查看区域信息
  4. 04为 LLM 助手查看可用工具

MCP 相关

该 SDK 连接 CzechFabric MCP 服务，客户端可列出其工具并生成提示词摘要。请求需要 API 密钥。

#transport#czechia#public-transport#real-time#ai#doprava#esko

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://mcp.czechfabric.cz
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址
Streamable HTTPhttps://mcp.czechfabric.cz需要授权

工具

13
参数类型必填说明
formatstring否响应格式：'tone'（节省令牌的 TONE 格式，默认）、'json'（标准 JSON）或 'both'（包含两种格式）
locationstring是布拉格的地点名称、地址或地标（例如：'Karlovo náměstí'、'Wenceslas Square'、'Anděl'）
radius_metersany否地点周围的搜索半径，单位为米（默认值：2000m = 2km）

详细介绍

PyPI License Downloads

🇨🇿 CzechFabric SDK

用于访问 Czech Intelligence Fabric (MCP) 的官方 Python SDK，这是一个统一 API，提供交通、地理位置和上下文 AI 工具等捷克公共服务。

🚀 功能

  • ✅ 使用 OpenTripPlanner 规划公共交通行程
  • 🚏 根据站点名称或坐标查询实时出发信息
  • 🗺️ 对地点进行地理编码／反向地理编码
  • 📍 查找附近站点
  • 📦 获取站点元数据和区域信息
  • 🧠 列出可用工具并生成适用于大模型的摘要
  • 🔁 内置重试、缓存和错误处理

📦 安装

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)

这对基于大模型的助手或调试可用功能很有帮助。

🔐 身份验证

所有请求都需要 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

🌐 项目链接

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。