Kiro CLI MCP Server

Instructions

Implementation Reference

• src/kiro_cli_mcp/server.py:265-278 (handler)

  The core handler function for the 'kiro_command' tool. It extracts the command and session_id from arguments, retrieves or creates the session, executes the command using CommandExecutor, and returns the result as a dictionary.

  async def _handle_command(
      session_manager: SessionManager,
      command_executor: CommandExecutor,
      arguments: dict[str, Any]
  ) -> dict[str, Any]:
      """Handle kiro_command tool call."""
      command = arguments.get("command", "")
      session_id = arguments.get("session_id")
  
      session = await session_manager.get_or_create_session(session_id)
      result = await command_executor.execute_command(session, command)
  
      return result.to_dict()

• src/kiro_cli_mcp/tools.py:83-99 (schema)

  Input schema for the 'kiro_command' tool, defining the required 'command' parameter and optional 'session_id'.

  {
      "name": "kiro_command",
      "description": "Execute a kiro-cli command (e.g., /mcp, /help)",
      "inputSchema": {
          "type": "object",
          "properties": {
              "command": {
                  "type": "string",
                  "description": "The command to execute"
              },
              "session_id": {
                  "type": "string",
                  "description": "Optional session ID"
              }
          },
          "required": ["command"]
      }

• src/kiro_cli_mcp/server.py:67-78 (registration)

  Registration of tools via the MCP list_tools handler, which includes 'kiro_command' from the tools.py TOOLS list.

  @server.list_tools()
  async def handle_list_tools() -> list[Tool]:
      """List available tools."""
      tools_data = get_all_tools()
      return [
          Tool(
              name=tool["name"],
              description=tool["description"],
              inputSchema=tool["inputSchema"]
          )
          for tool in tools_data
      ]

• src/kiro_cli_mcp/server.py:106-107 (handler)

  Dispatch routing in the main @server.call_tool() handler that directs 'kiro_command' calls to the specific _handle_command function.

  elif name == "kiro_command":
      result = await _handle_command(session_manager, command_executor, arguments)