feat(lark_mcp): 更新飞书卡片消息发送工具以支持单接收者

- 将send_card_message工具从接收ID列表改为单个接收者ID
- 修复test.py中导入并调用send_card_message的测试逻辑
- 新增机器人充电、终止任务、通知播放功能
- 扩展迎宾和巡逻功能参数，提供默认值和更灵活的配置
- 更新项目版本号至0.1.13和0.1.9

lzwcai_lark_mcp/lzwcai_lark_mcp/tools.py

@@ -52,16 +52,13 @@ tools = [
     ),
     Tool(
         name="send_card_message",
-        description="发送消息卡片，入参为receiver_ids、person_id和image_key",
+        description="发送消息卡片，入参为receiver_id、person_id和image_key",
         inputSchema={
             "type": "object",
             "properties": {
-                "receiver_ids": {
+                "receiver_id": {
-                    "type": "array",
+                    "type": "string",
-                    "description": "消息接收者ID列表",
+                    "description": "消息接收者ID"
-                    "items": {
-                        "type": "string"
-                    }
                 },
                 "person_id": {
                     "type": "string",
@@ -72,7 +69,7 @@ tools = [
                     "description": "图片image_key"
                 }
             },
-            "required": ["image_key"]
+            "required": ["receiver_id", "image_key"]
         }
     ),
     Tool(
@@ -1766,18 +1763,7 @@ def send_card_message(token: str, receiver_id: str, person_id: str, image_key: s
     return message_id
 
 
-def send_card_messages(token: str, receiver_ids: List[str], person_id: str, image_key: str) -> str:
+
-    if not receiver_ids:
-        raise ValueError("missing receiver_ids")
-    message_ids = []
-    for receiver_id in receiver_ids:
-        normalized_receiver_id = str(receiver_id).strip()
-        if not normalized_receiver_id:
-            continue
-        message_ids.append(send_card_message(token, normalized_receiver_id, person_id, image_key))
-    if not message_ids:
-        raise ValueError("missing receiver_ids")
-    return json.dumps(message_ids, ensure_ascii=False)
 
 
 async def handle_call_tool(name: str, arguments: Dict[str, object], token: str) -> List[TextContent]:
@@ -1816,16 +1802,13 @@ async def handle_call_tool(name: str, arguments: Dict[str, object], token: str)
                 result = upload_image_by_file(token, image_source, image_type)
         elif name == "send_card_message":
             image_key = str(arguments.get("image_key", "")).strip()
-            receiver_ids = arguments.get("receiver_ids")
+            receiver_id = str(arguments.get("receiver_id", "")).strip()
             person_id = str(arguments.get("person_id", "")).strip()
+            if not receiver_id:
+                raise ValueError("missing receiver_id")
             if not image_key:
                 raise ValueError("missing image_key")
-            if not person_id:
+            result = send_card_message(token, receiver_id, person_id, image_key)
-                raise ValueError("missing person_id")
-            if receiver_ids is not None:
-                if not isinstance(receiver_ids, list):
-                    raise ValueError("receiver_ids must be a list")
-                result = send_card_messages(token, receiver_ids, person_id, image_key)
         elif name == "send_confirmation_card":
             user_id = str(arguments.get("user_id", "")).strip()
             order_number = str(arguments.get("order_number", "")).strip()

lzwcai_lark_mcp/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "lzwcai-lark-mcp"
-version = "0.1.11"
+version = "0.1.13"
 description = "Lark MCP server"
 requires-python = ">=3.10"
 dependencies = [

lzwcai_lark_mcp/test.py

@@ -35,7 +35,7 @@ def main() -> None:
         mcp_module.types = types_module
         sys.modules["mcp"] = mcp_module
         sys.modules["mcp.types"] = types_module
-    from lzwcai_lark_mcp.tools import send_stranger_card
+    from lzwcai_lark_mcp.tools import send_card_message, send_stranger_card
     app_id = os.getenv("app_id", "")
     app_secret = os.getenv("app_secret", "")
     auth_url = "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal"
@@ -53,6 +53,18 @@ def main() -> None:
     if not token:
         raise RuntimeError(f"lark auth response missing token: {data}")
     user_id = "gegg1d78"
+    receiver_id = os.getenv("receiver_id", user_id)
+    person_id = os.getenv("person_id", "")
+    image_key = os.getenv("image_key", "").strip()
+    if not image_key:
+        raise RuntimeError("missing image_key")
+    card_message_id = send_card_message(
+        token,
+        receiver_id,
+        person_id,
+        image_key
+    )
+    print(card_message_id)
     result = send_stranger_card(
         token,
         user_id,

lzwcai_temi_mcp/lzwcai_temi_mcp/main.py

@@ -23,6 +23,24 @@ async def serve() -> None:
     async def list_tools() -> list[Tool]:
         """列出所有工具"""
         return [
+            Tool(
+                name="recharge",
+                description="轮足机器人充电",
+                inputSchema={
+                    "type": "object",
+                    "properties": {},
+                    "required": []
+                }
+            ),
+            Tool(
+                name="terminate",
+                description="轮足机器人终止当前任务",
+                inputSchema={
+                    "type": "object",
+                    "properties": {},
+                    "required": []
+                }
+            ),
             Tool(
                 name="goto",
                 description="轮足机器人导航到指定地点为用户引路。触发关键词：带我去、导航、引路、带路、怎么走、在哪里。",
@@ -61,16 +79,41 @@ async def serve() -> None:
                     "properties": {
                         "location": {
                             "type": "string",
-                            "description": "引导接待客人到这个位置",
+                            "description": "在这个位置接待贵宾",
                             "minLength": 1
                         },
                         "name": {
                             "type": "string",
                             "description": "客人姓名",
                             "minLength": 1
+                        },
+                        "destination": {
+                            "type": "string",
+                            "description": "接待贵宾到这个位置",
+                            "minLength": 1
                         }
                     },
-                    "required": ["location", "name"]
+                    "required": ["location", "name", "destination"]
+                }
+            ),
+            Tool(
+                name="notification",
+                description="轮足机器人去指定地点播放通知:通知、去那里说、去某地播报、传达消息",
+                inputSchema={
+                    "type": "object",
+                    "properties": {
+                        "location": {
+                            "type": "string",
+                            "description": "机器人需要前往的目标地点名称",
+                            "minLength": 1
+                        },
+                        "text": {
+                            "type": "string",
+                            "description": "到达地点后需要播放的文本内容",
+                            "minLength": 1
+                        }
+                    },
+                    "required": ["location", "text"]
                 }
             ),
             Tool(
@@ -84,19 +127,23 @@ async def serve() -> None:
             ),
             Tool(
                 name="patrol",
-                description="轮足机器人、助手、机器人去巡逻:巡逻、巡查、去检查一下、去看看、去巡视",
+                description="轮足机器人、助手、机器人去巡逻:巡逻、巡查、去检查一下、去看看、去巡视。支持按路线巡逻或随机巡逻。",
                 inputSchema={
                     "type": "object",
                     "properties": {
                         "locations": {
                             "type": "array",
-                            "description": "机器人巡逻经过的地点列表",
+                            "description": "机器人巡逻经过的地点列表。如果不提供，则默认进行随机巡逻。",
                             "items": {
                                 "type": "string"
                             }
+                        },
+                        "flag": {
+                            "type": "boolean",
+                            "description": "是否随机巡逻。True为随机巡逻，False为按locations指定的路线巡逻。"
                         }
                     },
-                    "required": ["locations"]
+                    "required": []
                 }
             )
         ]
@@ -106,7 +153,11 @@ async def serve() -> None:
         """处理工具调用"""
         try:
             result = ""
-            if name == "goto":
+            if name == "recharge":
+                result = await nav_server.recharge()
+            elif name == "terminate":
+                result = await nav_server.terminate()
+            elif name == "goto":
                 if "location" not in arguments:
                     raise ValueError("缺少必要参数: location")
                 result = await nav_server.goto(
@@ -122,16 +173,25 @@ async def serve() -> None:
                 if "location" not in arguments:
                     raise ValueError("缺少必要参数: location")
                 result = await nav_server.reception(
+                    location=arguments.get("location", "前台"),
+                    name=arguments.get("name", "贵宾"),
+                    destination=arguments.get("destination", "会议室")
+                )
+            elif name == "notification":
+                if "location" not in arguments or "text" not in arguments:
+                    raise ValueError("缺少必要参数: location or text")
+                result = await nav_server.notification(
                     location=arguments["location"],
-                    name=arguments.get("name", "贵宾")
+                    text=arguments["text"]
                 )
             elif name == "repose":
                 result = await nav_server.repose()
             elif name == "patrol":
-                if "locations" not in arguments:
+                locations = arguments.get("locations", [])
-                    raise ValueError("缺少必要参数: locations")
+                flag = arguments.get("flag", True if not locations else False)
                 result = await nav_server.patrol(
-                    locations=arguments["locations"]
+                    locations=locations,
+                    flag=flag
                 )
             else:
                 raise ValueError(f"未知工具: {name}")

lzwcai_temi_mcp/lzwcai_temi_mcp/nav_server.py

@@ -31,6 +31,25 @@ class NavServer:
             logger.error(f"Failed to publish command: {str(e)}", exc_info=True)
             return f"Failed to publish command: {str(e)}"
 
+
+    async def recharge(self):
+        """轮足机器人充电"""
+        try:
+            params = {}
+            return await self.pub_cmd("temi-test", "recharge", params)
+        except Exception as e:
+            logger.error(f"Failed to call recharge mcp-tool: {str(e)} ", exc_info=True)
+            return f"Failed to call recharge mcp-tool: {str(e)}"
+
+    async def terminate(self):
+        """轮足机器人终止当前任务"""
+        try:
+            params = {}
+            return await self.pub_cmd("temi-test", "terminate", params)
+        except Exception as e:
+            logger.error(f"Failed to call terminate mcp-tool: {str(e)} ", exc_info=True)
+            return f"Failed to call terminate mcp-tool: {str(e)}"
+
     async def goto(self, location: str, flag: bool = False):
         """轮足导航到指定位置"""
         try:
@@ -62,21 +81,34 @@ class NavServer:
             logger.error(f"Failed to call speak mcp-tool: {str(e)} ", exc_info=True)
             return f"Failed to call speak mcp-tool: {str(e)}"
 
-    async def reception(self, location: str, name: str = "贵宾"):
+    async def reception(self, location: str = "前台", name: str = "贵宾", destination: str = "会议室"):
         """轮足机器人移动到指定位置迎宾"""
         try:
-            if not location:
-                return "Location is not specified."
-            
             params = {
                 "location": location,
                 "text": f"您好，{name}，我是接待机器人。", 
+                "destination": destination
             }
             return await self.pub_cmd("temi-test", "reception", params)
         except Exception as e:
             logger.error(f"Failed to call reception mcp-tool: {str(e)} ", exc_info=True)
             return f"Failed to call reception mcp-tool: {str(e)}"
 
+    async def notification(self, location: str, text: str):
+        """轮足机器人移动到指定位置并播放通知文本"""
+        try:
+            if not location or not text:
+                return "Location or text is not specified."
+            
+            params = {
+                "location": location,
+                "text": text
+            }
+            return await self.pub_cmd("temi-test", "notification", params)
+        except Exception as e:
+            logger.error(f"Failed to call notification mcp-tool: {str(e)} ", exc_info=True)
+            return f"Failed to call notification mcp-tool: {str(e)}"
+
     async def repose(self):
         """轮足机器人重新定位"""
         try:
@@ -86,14 +118,12 @@ class NavServer:
             logger.error(f"Failed to call repose mcp-tool: {str(e)} ", exc_info=True)
             return f"Failed to call repose mcp-tool: {str(e)}"
 
-    async def patrol(self, locations: list):
+    async def patrol(self, locations: list = None, flag: bool = False):
-        """轮足机器人巡逻"""
+        """轮足机器人巡逻 why !!! """
         try:
-            if not locations:
-                return "locations is not specified."
             params = {
-                "flag": False,
+                "flag": True,
-                "locations": locations
+                "locations": locations or []
             }
             return await self.pub_cmd("temi-test", "patrol", params)
         except Exception as e:

lzwcai_temi_mcp/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "lzwcai_temi_mcp"
-version = "0.1.1"
+version = "0.1.9"
 description = "MQTT-based navigation server for robot"
 requires-python = ">=3.10"
 dependencies = [