工具管理概览¶

from mcpstore import MCPStore

# 初始化
store = MCPStore.setup_store()

# 1️⃣ 添加服务
store.for_store().add_service({
    "mcpServers": {
        "weather": {"url": "https://mcpstore.wiki/mcp"}
    }
})

# 2️⃣ 等待服务就绪
store.for_store().wait_service("weather")

# 3️⃣ 列出所有工具
tools = store.for_store().list_tools()
print(f"可用工具: {[t.name for t in tools]}")

# 4️⃣ 查找特定工具
tool_proxy = store.for_store().find_tool("get_current_weather")

# 5️⃣ 获取工具详情
info = tool_proxy.tool_info()
print(f"工具信息: {info['description']}")

# 6️⃣ 设置工具配置（可选）
tool_proxy.set_redirect(True)

# 7️⃣ 调用工具
result = tool_proxy.call_tool({"query": "北京"})
print(f"调用结果: {result.text_output}")

# 8️⃣ 查看统计
stats = tool_proxy.usage_stats()
print(f"调用次数: {stats['call_count']}")

# 9️⃣ 查看历史
history = tool_proxy.call_history(limit=5)
print(f"最近{len(history)}次调用")

# Store 级别（全局共享）
tools = store.for_store().list_tools()
tool = store.for_store().find_tool("get_weather")
result = store.for_store().call_tool("get_weather", {"query": "北京"})

# Agent 级别（独立隔离）
tools = store.for_agent("agent1").list_tools()
tool = store.for_agent("agent1").find_tool("get_weather")
result = store.for_agent("agent1").call_tool("get_weather", {"query": "上海"})

# Context 层级方法
store.for_store().find_tool("tool_name")   # 查找工具
store.for_store().list_tools()             # 列出工具
store.for_store().call_tool("name", args)  # 调用工具
store.for_store().use_tool("name", args)   # 调用工具别名

# ToolProxy 层级方法
tool_proxy = store.for_store().find_tool("tool_name")

tool_proxy.tool_info()          # 工具详情
tool_proxy.tool_tags()          # 工具标签
tool_proxy.tool_schema()        # 工具模式
tool_proxy.set_redirect(True)   # 设置重定向
tool_proxy.call_tool(args)      # 调用工具
tool_proxy.usage_stats()        # 使用统计
tool_proxy.call_history()       # 调用历史

# ServiceProxy 层级方法
svc = store.for_store().find_service("service_name")

svc.list_tools()      # 列出服务的工具
svc.tools_stats()     # 服务工具统计

# 获取 ToolProxy
tool_proxy = store.for_store().find_tool("tool_name")

# ToolProxy 提供的方法
tool_proxy.tool_info()          # 详情
tool_proxy.tool_tags()          # 标签
tool_proxy.tool_schema()        # 模式
tool_proxy.set_redirect()       # 配置
tool_proxy.call_tool()          # 调用
tool_proxy.usage_stats()        # 统计
tool_proxy.call_history()       # 历史

# 1. 简短名称
tool = store.for_store().find_tool("get_weather")

# 2. 服务前缀（双下划线）
tool = store.for_store().find_tool("weather__get_weather")

# 3. 服务前缀（单下划线）
tool = store.for_store().find_tool("weather_get_weather")