pip install woliumcp

pip install woliumcp[mcp]

from woliumcp import init, list_modules, get_module, get_all_mcp_configs

# 设置 WoLiu-AI-Agent 项目根目录
init(project_root="/path/to/WoLiu-AI-Agent")

# 列出所有已安装的服务模块
for m in list_modules():
    print(f"{m['id']}: {m['name']} (running={m['running']})")

# 获取单个模块的 MCP 配置
spine_mcp = get_module("spine2d").get_mcp_command()
print(spine_mcp)
# {'command': 'python', 'args': ['-m', 'spine2d_mcp.server'], 'cwd': '...'}

# 获取所有 MCP 配置，供 MCP 客户端连接
configs = get_all_mcp_configs()

python -m woliumcp /path/to/WoLiu-AI-Agent

cd WoLiu-AI-Agent
pip install woliumcp

server/app.py
    ├── 扫描 agent/mcp_modules/ 下的所有模块
    ├── 每个模块的 module.py 由 WoLiu-MCP 框架自动发现
    ├── 注册各模块提供的工具 Schema（供 LLM 调用）
    ├── 前端设置面板 → 显示模块开关/启停按钮
    ├── WebSocket handler → 接收前端点"开启"消息
    └── 子进程/HTTP 调用 → 启动各服务（ComfyUI、Presenton 等）

{
    "mcpServers": {
        "spine2d": {
            "command": "python",
            "args": ["-m", "spine2d_mcp.server"],
            "cwd": "./side-projects/spine2d-animation-mcp-main"
        },
        "agent-browser": {
            "command": "npx",
            "args": ["@playwright/mcp", "--headless"],
            "cwd": "."
        }
    }
}

from woliumcp.base import BaseMCPModule, ModuleMeta, ModuleHealth

class MyModule(BaseMCPModule):
    @property
    def meta(self) -> ModuleMeta:
        return ModuleMeta(
            id="my-module",
            name="我的模块",
            description="这是一个自定义 MCP 服务模块",
            icon="star",
            category="external",
        )

    def detect(self) -> bool:
        return self._exists("side-projects/my-module/main.py")

    def get_mcp_command(self) -> dict | None:
        return {
            "command": "python",
            "args": ["-m", "my_module.server"],
            "cwd": self._path("side-projects/my-module"),
        }

    async def health(self) -> ModuleHealth:
        return ModuleHealth(installed=self.detect())

{
    "mcpServers": {
        "spine2d": {
            "command": "python",
            "args": ["-m", "spine2d_mcp.server"],
            "cwd": "./side-projects/spine2d-animation-mcp-main"
        }
    }
}