MCP Vision Server

Instructions

Implementation Reference

• src/mcp_vision/server.py:272-306 (handler)

  Main handler function for the get_status tool. Returns server configuration and runtime status including server_name, provider, model, chat_manager status, and config details. Decorated with @mcp.tool() which also registers it as an MCP tool.

  @mcp.tool()
  async def get_status() -> dict[str, Any]:
      """
      获取服务器状态
  
      返回当前服务器配置和运行状态信息。
  
      ---
      **返回内容**：
      - `server_name`: 服务器名称
      - `provider`: AI服务提供商
      - `model`: 当前使用的模型
      - `chat_manager`: 对话管理器状态
      - `config`: 当前配置信息
      """
      from .chat_manager import MAX_CONVERSATION_TURNS
  
      vision_config = get_vision_config()
      chat_manager = get_chat_manager()
  
      return {
          "server_name": server_config.name,
          "provider": vision_config.provider,
          "model": vision_config.model,
          "chat_manager": chat_manager.get_status(),
          "config": {
              "max_image_size_mb": vision_config.max_image_size / (1024 * 1024),
              "timeout": vision_config.timeout,
              "temperature": vision_config.temperature,
              "max_tokens": vision_config.max_tokens,
              "max_history": server_config.max_history,
              "persistence_enabled": server_config.enable_persistence,
              "max_conversation_turns": MAX_CONVERSATION_TURNS,
          }
      }

• src/mcp_vision/chat_manager.py:313-328 (helper)

  Helper method that returns the chat manager's status, including active_sessions, persistence_enabled, history_file, max_history, and max_conversation_turns. Called by the main get_status handler.

  def get_status(self) -> dict[str, Any]:
      """
      获取管理器状态
  
      Returns:
          dict: 状态信息
      """
      server_config = get_server_config()
  
      return {
          "active_sessions": len(self._sessions),
          "persistence_enabled": self._persistence_enabled,
          "history_file": str(self._history_file) if self._history_file else None,
          "max_history": server_config.max_history,
          "max_conversation_turns": MAX_CONVERSATION_TURNS,
      }