一个路由表，多种协议。¶

toolregistry-server 是什么？¶

toolregistry-server 是 ToolRegistry 生态系统中的服务层。它将包含 Python 函数的 ToolRegistry 暴露为网络服务——通过 OpenAPI 提供 REST API，或通过 Model Context Protocol (MCP) 提供 LLM 工具接口。

toolregistry（核心）          → 定义和管理工具
toolregistry-server（本项目） → 通过 OpenAPI 和 MCP 提供工具服务
toolregistry-hub（扩展）      → 精选的即用型工具集合

快速开始¶

pip install toolregistry-server[all]

from toolregistry import ToolRegistry
from toolregistry_server import RouteTable
from toolregistry_server.openapi import create_openapi_app

registry = ToolRegistry()

@registry.register
def greet(name: str) -> str:
    """按名字问候某人。"""
    return f"Hello, {name}!"

route_table = RouteTable(registry)
app = create_openapi_app(route_table)

安装 → · 快速开始 → · 示例 →

核心特性¶

• 中央路由表 — 连接 ToolRegistry 和协议适配器的统一路由层
• OpenAPI 适配器 — 自动生成 schema 的 RESTful HTTP 端点
• MCP 适配器 — 用于 LLM 集成的 Model Context Protocol
• 认证 — 内置 Bearer 令牌支持
• CLI — 通过配置文件运行服务器，无需编写代码
• 动态启用/禁用 — 运行时切换工具状态，无需重启
• ETag 缓存 — 通过 ETag 头实现高效 HTTP 缓存

架构¶

graph TD
    TR[ToolRegistry<br/>工具定义]
    RT[RouteTable<br/>中央路由层<br/><i>RouteEntry · RouteEntry · ...</i>]
    OA[OpenAPI 适配器<br/>FastAPI · REST]
    MA[MCP 适配器<br/>MCP SDK · LLM 集成]
    GA[gRPC 适配器<br/>规划中]

    TR --> RT
    RT --> OA
    RT --> MA
    RT -.-> GA

许可证¶

ToolRegistry Server 使用 MIT 许可证。