跳转至

update_service()

完全替换服务配置。

方法特性

  • ✅ 异步版本: update_service_async()
  • ✅ Store级别: store.for_store().update_service()
  • ✅ Agent级别: store.for_agent("agent1").update_service()
  • 📁 文件位置: service_management.py
  • 🏷️ 所属类: ServiceManagementMixin

参数

参数名类型必需默认值描述
namestr✅-服务名称
configDict[str, Any]✅-新的服务配置

返回值

  • 成功: 返回 True
  • 失败: 返回 False

使用示例

Store级别更新服务

from mcpstore import MCPStore

# 初始化
store = MCPStore.setup_store()

# 完全替换服务配置
new_config = {
    "url": "https://api.newweather.com/mcp",
    "transport": "http",
    "timeout": 30,
    "headers": {
        "Authorization": "Bearer new-token"
    }
}

success = store.for_store().update_service("weather", new_config)
if success:
    print("Weather服务配置已更新")
else:
    print("Weather服务配置更新失败")

Agent级别更新服务

from mcpstore import MCPStore

# 初始化
store = MCPStore.setup_store()

# Agent模式更新服务
new_config = {
    "command": "python",
    "args": ["weather_server.py", "--port", "8080"],
    "env": {
        "API_KEY": "new-api-key"
    }
}

success = store.for_agent("agent1").update_service("weather-local", new_config)
if success:
    print("Agent Weather服务配置已更新")

更新URL服务

from mcpstore import MCPStore

# 初始化
store = MCPStore.setup_store()

# 更新URL类型服务
url_config = {
    "url": "https://api.upgraded-weather.com/mcp",
    "transport": "http",
    "headers": {
        "User-Agent": "MCPStore/1.0",
        "API-Version": "v2"
    },
    "timeout": 60
}

success = store.for_store().update_service("weather", url_config)
print(f"URL服务更新: {'成功' if success else '失败'}")

更新命令服务

from mcpstore import MCPStore

# 初始化
store = MCPStore.setup_store()

# 更新命令类型服务
command_config = {
    "command": "node",
    "args": ["weather-server.js", "--config", "production.json"],
    "cwd": "/opt/weather-service",
    "env": {
        "NODE_ENV": "production",
        "LOG_LEVEL": "info"
    }
}

success = store.for_store().update_service("weather", command_config)
print(f"命令服务更新: {'成功' if success else '失败'}")

异步版本

import asyncio
from mcpstore import MCPStore

async def async_update_service():
    # 初始化
    store = MCPStore.setup_store()

    # 新配置
    new_config = {
        "url": "https://api.async-weather.com/mcp",
        "transport": "websocket",
        "reconnect": True
    }

    # 异步更新服务
    success = await store.for_store().update_service_async("weather", new_config)

    if success:
        print("异步更新成功")
        # 验证更新结果
        service_info = await store.for_store().get_service_info_async("weather")
        print(f"更新后的服务信息: {service_info}")

    return success

# 运行异步更新
result = asyncio.run(async_update_service())

批量更新服务

from mcpstore import MCPStore

# 初始化
store = MCPStore.setup_store()

# 批量更新多个服务
services_to_update = {
    "weather": {
        "url": "https://api.weather-v2.com/mcp",
        "timeout": 30
    },
    "database": {
        "command": "python",
        "args": ["db_server.py", "--version", "2.0"]
    }
}

for service_name, config in services_to_update.items():
    success = store.for_store().update_service(service_name, config)
    print(f"更新 {service_name}: {'成功' if success else '失败'}")

配置格式

URL服务配置

{
    "url": "https://api.example.com/mcp",
    "transport": "http|websocket",
    "headers": {"key": "value"},
    "timeout": 30,
    "reconnect": True
}

命令服务配置

{
    "command": "executable",
    "args": ["arg1", "arg2"],
    "cwd": "/working/directory",
    "env": {"VAR": "value"}
}

与 patch_service() 的区别

特性update_service()patch_service()
更新方式完全替换增量更新
原有配置会被清除会被保留
使用场景重大配置变更小幅调整
安全性需要完整配置更安全

相关方法

注意事项

  1. 完全替换: 会清除所有原有配置，只保留新提供的配置
  2. 服务重启: 更新配置后服务会自动重启
  3. 配置验证: 新配置会进行格式验证
  4. Agent映射: Agent模式下自动处理服务名映射
  5. 推荐使用: 对于小幅修改，推荐使用 patch_service()