示例¶
可运行的示例位于仓库的 examples/ 目录中。以下代码片段供快速参考。
共享工具模块¶
所有示例从同一个共享模块导入工具：
examples/tools.py
def add(a: float, b: float) -> float:
"""将两个数字相加。"""
return a + b
def greet(name: str) -> str:
"""按名字问候某人。"""
return f"Hello, {name}!"
def multiply(a: float, b: float) -> float:
"""将两个数字相乘。"""
return a * b
编程方式 — OpenAPI 服务器¶
创建 FastAPI 应用并通过 Uvicorn 运行：
examples/openapi_server.py
from toolregistry import ToolRegistry
from toolregistry_server import RouteTable
from toolregistry_server.openapi import create_openapi_app
from tools import add, greet, multiply
registry = ToolRegistry()
registry.register(add)
registry.register(greet)
registry.register(multiply)
route_table = RouteTable(registry)
app = create_openapi_app(route_table)
if __name__ == "__main__":
import uvicorn
uvicorn.run(app, host="0.0.0.0", port=8000)
cd examples
python openapi_server.py
# Swagger UI → http://localhost:8000/docs
# 工具列表 → http://localhost:8000/tools
编程方式 — MCP 服务器¶
通过 stdio 暴露相同的工具，供 MCP 兼容客户端使用：
examples/mcp_server.py
import asyncio
from toolregistry import ToolRegistry
from toolregistry_server import RouteTable
from toolregistry_server.mcp import create_mcp_server, run_stdio
from tools import add, greet, multiply
registry = ToolRegistry()
registry.register(add)
registry.register(greet)
registry.register(multiply)
route_table = RouteTable(registry)
server = create_mcp_server(route_table)
if __name__ == "__main__":
asyncio.run(run_stdio(server))
CLI 配置文件方式¶
CLI 可以从 JSON/JSONC 配置文件启动任一类型的服务器，无需编写 Python 代码：
examples/config.jsonc
{
"mode": "denylist",
"disabled": [],
"tools": [
{
"type": "python",
"module": "examples.tools",
"namespace": "examples"
}
]
}