初始化提交

backend/app/integrations/mcp/transports/base.py

@@ -0,0 +1,57 @@
+"""TransportProtocol — MCP 传输层抽象接口。
+
+定义所有传输层（streamable-http / stdio）共有的 list_tools / call_tool / 生命周期方法。
+"""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import Any
+
+from app.modules.tool_runtime.definition import ToolResult
+
+
+class TransportProtocol(ABC):
+    """MCP 传输层协议接口。"""
+
+    server_id: str
+    server_name: str
+
+    @abstractmethod
+    async def list_tools(self) -> list[dict[str, Any]]:
+        """调用 tools/list，返回工具清单。"""
+        ...
+
+    @abstractmethod
+    async def call_tool(self, name: str, arguments: dict[str, Any]) -> ToolResult:
+        """调用 tools/call，返回 ToolResult。"""
+        ...
+
+    async def start(self) -> None:
+        """启动传输层（stdio 启子进程；HTTP no-op）。"""
+        return
+
+    async def stop(self) -> None:
+        """停止传输层（stdio 杀子进程；HTTP no-op）。"""
+        return
+
+    async def restart(self) -> None:
+        """重启传输层。"""
+        await self.stop()
+        await self.start()
+
+    @property
+    def is_running(self) -> bool:
+        """传输层是否正在运行。"""
+        return True
+
+    async def get_status(self) -> dict[str, Any]:
+        """返回当前状态信息。"""
+        return {
+            "server_id": self.server_id,
+            "name": self.server_name,
+            "transport": "unknown",
+            "status": "unknown",
+            "pid": None,
+            "uptime_seconds": None,
+        }