ks-app-sdk 0.2.0

Keystone 平台 MCP Service SDK（Python）

ks-app-sdk

Keystone MCP Service SDK for Python.

安装

pip install ks-app-sdk

使用

from ks_app import App

app = App("my-app")

@app.tool("greet", "打招呼") async def greet(name: str = "world"): return {"message": f"Hello, {name}!"}

app.run() # 监听 0.0.0.0:8080

API

App(app_id: str)

创建应用实例。

@app.tool(name: str, description: str)

注册工具（装饰器）。handler 必须是 async 函数。

app.run()

启动 uvicorn 服务器。

端点

路径	方法	说明
/healthz	GET	存活探针
/readyz	GET	就绪探针
/meta	GET	应用元信息 + 工具列表
/mcp/tools/list	GET	已注册工具列表
/mcp/tools/call	POST	调用工具

配置

环境变量	默认值	说明
KS_APP_PORT	8080	监听端口
KS_APP_HOST	0.0.0.0	监听地址