TOS MCP Server

Instructions

Implementation Reference

• src/tos_mcp_server/handlers.py:261-293 (handler)

  The main handler function for the 'tos_image_info' tool. It retrieves image metadata from TOS using the get_object API with process='image/info', parses the JSON response, and returns it structured with bucket and key info.

  async def image_info(args: Dict[str, Any]) -> List[TextContent]:
      """获取图片信息"""
      bucket_name = args["bucket_name"]
      object_key = args["object_key"]
      
      try:
          # 使用 get_object 方法通过 style 参数获取图片信息
          # 设置处理参数为 image/info
          resp = tos_client.get_object(bucket_name, object_key, process="image/info")
          image_info_data = resp.read().decode('utf-8')
          
          # 尝试解析JSON响应
          try:
              image_info_json = json.loads(image_info_data)
              result = {
                  "bucket": bucket_name,
                  "key": object_key,
                  "image_info": image_info_json,
                  "status": "success"
              }
          except json.JSONDecodeError:
              # 如果不是JSON格式，直接返回原始数据
              result = {
                  "bucket": bucket_name,
                  "key": object_key,
                  "image_info": image_info_data,
                  "status": "success",
                  "note": "返回原始格式数据"
              }
          
          return [TextContent(type="text", text=json.dumps(result, indent=2, ensure_ascii=False))]
      except Exception as e:
          return [TextContent(type="text", text=f"获取图片信息失败: {str(e)}")]

• src/tos_mcp_server/server.py:225-242 (registration)

  Registers the 'tos_image_info' tool in the MCP server's list_tools() function, including name, description, and input schema.

  Tool(
      name="tos_image_info",
      description="获取图片信息",
      inputSchema={
          "type": "object",
          "properties": {
              "bucket_name": {
                  "type": "string",
                  "description": "存储桶名称"
              },
              "object_key": {
                  "type": "string",
                  "description": "图片对象键名"
              }
          },
          "required": ["bucket_name", "object_key"]
      }
  ),

• src/tos_mcp_server/server.py:357-358 (registration)

  In the call_tool dispatcher, routes 'tos_image_info' calls to the image_info handler function.

  elif name == "tos_image_info":
      return await image_info(arguments)

• src/tos_mcp_server/server.py:228-241 (schema)

  Input schema definition for the 'tos_image_info' tool, specifying required parameters bucket_name and object_key.

  inputSchema={
      "type": "object",
      "properties": {
          "bucket_name": {
              "type": "string",
              "description": "存储桶名称"
          },
          "object_key": {
              "type": "string",
              "description": "图片对象键名"
          }
      },
      "required": ["bucket_name", "object_key"]
  }